.TH "KListView" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdeui Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KListView \- This Widget extends the functionality of \fBQListView\fP to honor the system wide settings for Single Click/Double Click mode, AutoSelection and ChangeCursorOverLink (TM).  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <klistview.h>\fP
.PP
Inherits \fBQListView\fP.
.PP
Inherited by \fBKFileDetailView\fP, \fBKFileTreeView\fP, \fBListProgress\fP, and ToolbarListView.
.PP
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBSelectionModeExt\fP { \fBSingle\fP =  QListView::Single, \fBMulti\fP =  QListView::Multi, \fBExtended\fP =  QListView::Extended, \fBNoSelection\fP =  QListView::NoSelection, \fBFileManager\fP }"
.br
.in -1c
.SS "Public Slots"

.in +1c
.ti -1c
.RI "virtual void \fBrename\fP (\fBQListViewItem\fP *item, int c)"
.br
.ti -1c
.RI "void \fBsetRenameable\fP (int column, bool yesno=true)"
.br
.ti -1c
.RI "virtual void \fBsetItemsMovable\fP (bool b)"
.br
.ti -1c
.RI "virtual void \fBsetItemsRenameable\fP (bool b)"
.br
.ti -1c
.RI "virtual void \fBsetDragEnabled\fP (bool b)"
.br
.ti -1c
.RI "virtual void \fBsetAutoOpen\fP (bool b)"
.br
.ti -1c
.RI "virtual void \fBsetDropVisualizer\fP (bool b)"
.br
.ti -1c
.RI "void \fBsetDropVisualizerWidth\fP (int w)"
.br
.ti -1c
.RI "virtual void \fBsetTooltipColumn\fP (int column)"
.br
.ti -1c
.RI "virtual void \fBsetDropHighlighter\fP (bool b)"
.br
.ti -1c
.RI "virtual void \fBsetCreateChildren\fP (bool b) KDE_DEPRECATED"
.br
.ti -1c
.RI "void \fBsetSelectionModeExt\fP (\fBSelectionModeExt\fP mode)"
.br
.ti -1c
.RI "void \fBsetTabOrderedRenaming\fP (bool b)"
.br
.ti -1c
.RI "bool \fBtabOrderedRenaming\fP () const "
.br
.in -1c
.SS "Signals"

.in +1c
.ti -1c
.RI "void \fBexecuted\fP (\fBQListViewItem\fP *item)"
.br
.ti -1c
.RI "void \fBexecuted\fP (\fBQListViewItem\fP *item, const \fBQPoint\fP &pos, int c)"
.br
.ti -1c
.RI "void \fBdropped\fP (\fBQDropEvent\fP *e, \fBQListViewItem\fP *after)"
.br
.ti -1c
.RI "void \fBdropped\fP (\fBKListView\fP *list, \fBQDropEvent\fP *e, \fBQListViewItem\fP *after)"
.br
.ti -1c
.RI "void \fBdropped\fP (\fBKListView\fP *list, \fBQDropEvent\fP *e, \fBQListViewItem\fP *parent, \fBQListViewItem\fP *after)"
.br
.ti -1c
.RI "void \fBdropped\fP (\fBQDropEvent\fP *e, \fBQListViewItem\fP *parent, \fBQListViewItem\fP *after)"
.br
.ti -1c
.RI "void \fBmoved\fP ()"
.br
.ti -1c
.RI "void \fBaboutToMove\fP ()"
.br
.ti -1c
.RI "void \fBmoved\fP (\fBQListViewItem\fP *item, \fBQListViewItem\fP *afterFirst, \fBQListViewItem\fP *afterNow)"
.br
.ti -1c
.RI "void \fBmoved\fP (\fBQPtrList\fP< \fBQListViewItem\fP > &items, \fBQPtrList\fP< \fBQListViewItem\fP > &afterFirst, \fBQPtrList\fP< \fBQListViewItem\fP > &afterNow)"
.br
.ti -1c
.RI "void \fBitemRenamed\fP (\fBQListViewItem\fP *item, const \fBQString\fP &str, int col)"
.br
.ti -1c
.RI "void \fBitemRenamed\fP (\fBQListViewItem\fP *item)"
.br
.ti -1c
.RI "void \fBmenuShortCutPressed\fP (\fBKListView\fP *list, \fBQListViewItem\fP *item)"
.br
.ti -1c
.RI "void \fBcontextMenu\fP (\fBKListView\fP *l, \fBQListViewItem\fP *i, const \fBQPoint\fP &p)"
.br
.ti -1c
.RI "void \fBitemAdded\fP (\fBQListViewItem\fP *item)"
.br
.ti -1c
.RI "void \fBitemRemoved\fP (\fBQListViewItem\fP *item)"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKListView\fP (\fBQWidget\fP *parent=0, const char *name=0)"
.br
.ti -1c
.RI "virtual \fB~KListView\fP ()"
.br
.ti -1c
.RI "virtual void \fBsetAcceptDrops\fP (bool)"
.br
.ti -1c
.RI "virtual bool \fBisExecuteArea\fP (const \fBQPoint\fP &point)"
.br
.ti -1c
.RI "bool \fBisExecuteArea\fP (int x)"
.br
.ti -1c
.RI "\fBQPtrList\fP< \fBQListViewItem\fP > \fBselectedItems\fP () const "
.br
.ti -1c
.RI "\fBQPtrList\fP< \fBQListViewItem\fP > \fBselectedItems\fP (bool includeHiddenItems) const "
.br
.ti -1c
.RI "void \fBmoveItem\fP (\fBQListViewItem\fP *item, \fBQListViewItem\fP *parent, \fBQListViewItem\fP *after)"
.br
.ti -1c
.RI "\fBQListViewItem\fP * \fBlastItem\fP () const "
.br
.ti -1c
.RI "\fBQListViewItem\fP * \fBlastChild\fP () const "
.br
.ti -1c
.RI "\fBKLineEdit\fP * \fBrenameLineEdit\fP () const "
.br
.ti -1c
.RI "bool \fBitemsMovable\fP () const "
.br
.ti -1c
.RI "bool \fBitemsRenameable\fP () const "
.br
.ti -1c
.RI "bool \fBdragEnabled\fP () const "
.br
.ti -1c
.RI "bool \fBautoOpen\fP () const "
.br
.ti -1c
.RI "bool \fBisRenameable\fP (int column) const "
.br
.ti -1c
.RI "bool \fBdropVisualizer\fP () const "
.br
.ti -1c
.RI "int \fBtooltipColumn\fP () const "
.br
.ti -1c
.RI "bool \fBcreateChildren\fP () const KDE_DEPRECATED"
.br
.ti -1c
.RI "bool \fBdropHighlighter\fP () const "
.br
.ti -1c
.RI "int \fBdropVisualizerWidth\fP () const "
.br
.ti -1c
.RI "\fBSelectionModeExt\fP \fBselectionModeExt\fP () const "
.br
.ti -1c
.RI "int \fBitemIndex\fP (const \fBQListViewItem\fP *item) const "
.br
.ti -1c
.RI "\fBQListViewItem\fP * \fBitemAtIndex\fP (int index)"
.br
.ti -1c
.RI "void \fBsetFullWidth\fP () KDE_DEPRECATED"
.br
.ti -1c
.RI "void \fBsetFullWidth\fP (bool fullWidth)"
.br
.ti -1c
.RI "bool \fBfullWidth\fP () const "
.br
.ti -1c
.RI "virtual int \fBaddColumn\fP (const \fBQString\fP &label, int width=-1)"
.br
.ti -1c
.RI "virtual int \fBaddColumn\fP (const \fBQIconSet\fP &iconset, const \fBQString\fP &label, int width=-1)"
.br
.ti -1c
.RI "virtual void \fBremoveColumn\fP (int index)"
.br
.ti -1c
.RI "void \fBsetAlternateBackground\fP (const \fBQColor\fP &c)"
.br
.ti -1c
.RI "const \fBQColor\fP & \fBalternateBackground\fP () const "
.br
.ti -1c
.RI "void \fBsaveLayout\fP (\fBKConfig\fP *config, const \fBQString\fP &group) const "
.br
.ti -1c
.RI "void \fBrestoreLayout\fP (\fBKConfig\fP *config, const \fBQString\fP &group)"
.br
.ti -1c
.RI "virtual void \fBsetSorting\fP (int column, bool ascending=true)"
.br
.ti -1c
.RI "int \fBcolumnSorted\fP (void) const "
.br
.ti -1c
.RI "bool \fBascendingSort\fP (void) const "
.br
.ti -1c
.RI "virtual void \fBtakeItem\fP (\fBQListViewItem\fP *i)"
.br
.ti -1c
.RI "void \fBsetShadeSortColumn\fP (bool shadeSortColumn)"
.br
.ti -1c
.RI "bool \fBshadeSortColumn\fP (void) const "
.br
.in -1c
.SS "Protected Slots"

.in +1c
.ti -1c
.RI "void \fBslotSettingsChanged\fP (int)"
.br
.ti -1c
.RI "void \fBslotMouseButtonClicked\fP (int btn, \fBQListViewItem\fP *item, const \fBQPoint\fP &pos, int c)"
.br
.ti -1c
.RI "void \fBdoneEditing\fP (\fBQListViewItem\fP *item, int row)"
.br
.ti -1c
.RI "void \fBcleanDropVisualizer\fP ()"
.br
.ti -1c
.RI "void \fBcleanItemHighlighter\fP ()"
.br
.ti -1c
.RI "void \fBemitContextMenu\fP (\fBQListViewItem\fP *, const \fBQPoint\fP &, int)"
.br
.ti -1c
.RI "void \fBemitContextMenu\fP (\fBKListView\fP *, \fBQListViewItem\fP *)"
.br
.ti -1c
.RI "void \fBslotOnItem\fP (\fBQListViewItem\fP *item)"
.br
.ti -1c
.RI "void \fBslotOnViewport\fP ()"
.br
.ti -1c
.RI "void \fBslotAutoSelect\fP ()"
.br
.ti -1c
.RI "void \fBslotDragExpand\fP ()"
.br
.ti -1c
.RI "void \fBslotHeaderChanged\fP ()"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "bool \fBbelow\fP (const \fBQRect\fP &rect, const \fBQPoint\fP &p)"
.br
.ti -1c
.RI "bool \fBbelow\fP (\fBQListViewItem\fP *i, const \fBQPoint\fP &p)"
.br
.ti -1c
.RI "virtual bool \fBevent\fP (\fBQEvent\fP *)"
.br
.ti -1c
.RI "void \fBemitExecute\fP (\fBQListViewItem\fP *item, const \fBQPoint\fP &pos, int c)"
.br
.ti -1c
.RI "virtual void \fBfocusInEvent\fP (\fBQFocusEvent\fP *fe)"
.br
.ti -1c
.RI "virtual void \fBfocusOutEvent\fP (\fBQFocusEvent\fP *fe)"
.br
.ti -1c
.RI "virtual void \fBleaveEvent\fP (\fBQEvent\fP *e)"
.br
.ti -1c
.RI "virtual \fBQString\fP \fBtooltip\fP (\fBQListViewItem\fP *item, int column) const "
.br
.ti -1c
.RI "virtual bool \fBshowTooltip\fP (\fBQListViewItem\fP *item, const \fBQPoint\fP &pos, int column) const "
.br
.ti -1c
.RI "virtual void \fBcontentsDragMoveEvent\fP (\fBQDragMoveEvent\fP *event)"
.br
.ti -1c
.RI "virtual void \fBcontentsMousePressEvent\fP (\fBQMouseEvent\fP *e)"
.br
.ti -1c
.RI "virtual void \fBcontentsMouseMoveEvent\fP (\fBQMouseEvent\fP *e)"
.br
.ti -1c
.RI "virtual void \fBcontentsMouseDoubleClickEvent\fP (\fBQMouseEvent\fP *e)"
.br
.ti -1c
.RI "virtual void \fBcontentsDragLeaveEvent\fP (\fBQDragLeaveEvent\fP *event)"
.br
.ti -1c
.RI "virtual void \fBcontentsMouseReleaseEvent\fP (\fBQMouseEvent\fP *)"
.br
.ti -1c
.RI "virtual void \fBcontentsDropEvent\fP (\fBQDropEvent\fP *)"
.br
.ti -1c
.RI "virtual void \fBcontentsDragEnterEvent\fP (\fBQDragEnterEvent\fP *)"
.br
.ti -1c
.RI "virtual \fBQDragObject\fP * \fBdragObject\fP ()"
.br
.ti -1c
.RI "virtual bool \fBacceptDrag\fP (\fBQDropEvent\fP *event) const "
.br
.ti -1c
.RI "virtual \fBQRect\fP \fBdrawDropVisualizer\fP (\fBQPainter\fP *p, \fBQListViewItem\fP *parent, \fBQListViewItem\fP *after)"
.br
.ti -1c
.RI "virtual \fBQRect\fP \fBdrawItemHighlighter\fP (\fBQPainter\fP *painter, \fBQListViewItem\fP *item)"
.br
.ti -1c
.RI "virtual void \fBstartDrag\fP ()"
.br
.ti -1c
.RI "virtual void \fBkeyPressEvent\fP (\fBQKeyEvent\fP *)"
.br
.ti -1c
.RI "virtual void \fBviewportPaintEvent\fP (\fBQPaintEvent\fP *)"
.br
.ti -1c
.RI "void \fBactivateAutomaticSelection\fP ()"
.br
.ti -1c
.RI "void \fBdeactivateAutomaticSelection\fP ()"
.br
.ti -1c
.RI "bool \fBautomaticSelection\fP () const "
.br
.ti -1c
.RI "virtual void \fBviewportResizeEvent\fP (\fBQResizeEvent\fP *e)"
.br
.ti -1c
.RI "void \fBdisableAutoSelection\fP ()"
.br
.ti -1c
.RI "void \fBresetAutoSelection\fP ()"
.br
.ti -1c
.RI "void \fBdoubleClicked\fP (\fBQListViewItem\fP *item, const \fBQPoint\fP &pos, int c)"
.br
.ti -1c
.RI "virtual void \fBmovableDropEvent\fP (\fBQListViewItem\fP *parent, \fBQListViewItem\fP *afterme)"
.br
.ti -1c
.RI "virtual void \fBfindDrop\fP (const \fBQPoint\fP &pos, \fBQListViewItem\fP *&parent, \fBQListViewItem\fP *&after)"
.br
.ti -1c
.RI "void \fBfileManagerKeyPressEvent\fP (\fBQKeyEvent\fP *)"
.br
.ti -1c
.RI "int \fBdepthToPixels\fP (int depth)"
.br
.ti -1c
.RI "virtual void \fBvirtual_hook\fP (int id, void *data)"
.br
.in -1c
.SS "Properties"

.in +1c
.ti -1c
.RI "bool \fBfullWidth\fP"
.br
.ti -1c
.RI "bool \fBitemsMovable\fP"
.br
.ti -1c
.RI "bool \fBitemsRenameable\fP"
.br
.ti -1c
.RI "bool \fBdragEnabled\fP"
.br
.ti -1c
.RI "bool \fBautoOpen\fP"
.br
.ti -1c
.RI "bool \fBdropVisualizer\fP"
.br
.ti -1c
.RI "int \fBtooltipColumn\fP"
.br
.ti -1c
.RI "int \fBdropVisualizerWidth\fP"
.br
.ti -1c
.RI "\fBQColor\fP \fBalternateBackground\fP"
.br
.ti -1c
.RI "bool \fBshadeSortColumn\fP"
.br
.in -1c
.SS "Friends"

.in +1c
.ti -1c
.RI "class \fBKListViewItem\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
This Widget extends the functionality of \fBQListView\fP to honor the system wide settings for Single Click/Double Click mode, AutoSelection and ChangeCursorOverLink (TM). 

There is a new signal \fBexecuted()\fP. It gets connected to either \fBQListView::clicked()\fP or \fBQListView::doubleClicked()\fP depending on the \fBKDE\fP wide Single Click/Double Click settings. It is strongly recommended that you use this signal instead of the above mentioned. This way you donīt need to care about the current settings. If you want to get informed when the user selects something connect to the \fBQListView::selectionChanged()\fP signal.
.PP
Drag-and-Drop is supported with the signal \fBdropped()\fP, just setAcceptDrops(true) and connect it to a suitable slot. To see where you are dropping, setDropVisualizer(true). And also you'll need acceptDrag(QDropEvent*)
.PP
KListView is drag-enabled, too: to benefit from that you've got derive from it. Reimplement \fBdragObject()\fP and (possibly) \fBstartDrag()\fP, and setDragEnabled(true). 
.PP
Definition at line 53 of file klistview.h.
.SH "Member Enumeration Documentation"
.PP 
.SS "\fBenum\fP \fBKListView::SelectionModeExt\fP"
.PP
Possible selection modes. 
.PP
The first four correspond directly to QListView::SelectionMode, while the FileManager selection mode is defined as follows: 
.PD 0

.IP "\(bu" 2
home: move to the first 
.IP "\(bu" 2
end: move to the last 
.IP "\(bu" 2
PgUp/PgDn: move one page up/down 
.IP "\(bu" 2
up/down: move one item up/down 
.IP "\(bu" 2
insert: toggle selection of current and move to the next 
.IP "\(bu" 2
space: toggle selection of the current 
.IP "\(bu" 2
CTRL+up: move to the previous item and toggle selection of this one 
.IP "\(bu" 2
CTRL+down: toggle selection of the current item and move to the next 
.IP "\(bu" 2
CTRL+end: toggle selection from (including) the current item to (including) the last item 
.IP "\(bu" 2
CTRL+home: toggle selection from (including) the current item to the (including) the first item 
.IP "\(bu" 2
CTRL+PgDn: toggle selection from (including) the current item to (excluding) the item one page down 
.IP "\(bu" 2
CTRL+PgUp: toggle selection from (excluding) the current item to (including) the item one page up
.PP
The combinations work the same with SHIFT instead of CTRL, except that if you start selecting something using SHIFT everything selected before will be deselected first.
.PP
Additionally the current item is always selected automatically when navigating using the keyboard, except other items were selected explicitly.
.PP
This way e.g. SHIFT+up/PgUp then SHIFT+down/PgDn leaves no item selected 
.PP
Definition at line 104 of file klistview.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KListView::KListView (\fBQWidget\fP * parent = \fC0\fP, const char * name = \fC0\fP)"
.PP
Constructor. 
.PP
The parameters \fCparent\fP and \fCname\fP are handled by \fBQListView\fP, as usual. 
.PP
Definition at line 410 of file klistview.cpp.
.PP
References KGlobalSettings::alternateBackgroundColor(), cleanDropVisualizer(), cleanItemHighlighter(), emitContextMenu(), menuShortCutPressed(), QListView::onItem(), QListView::onViewport(), slotAutoSelect(), slotOnItem(), slotOnViewport(), and slotSettingsChanged().
.SS "KListView::~\fBKListView\fP ()\fC [virtual]\fP"
.PP
Destructor. 
.PP
Definition at line 455 of file klistview.cpp.
.SH "Member Function Documentation"
.PP 
.SS "void KListView::setAcceptDrops (bool)\fC [virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Definition at line 1893 of file klistview.cpp.
.SS "bool KListView::isExecuteArea (const \fBQPoint\fP & point)\fC [virtual]\fP"
.PP
This function determines whether the given coordinates are within the execute area. 
.PP
The execute area is the part of a \fBQListViewItem\fP where mouse clicks or double clicks respectively generate a \fBexecuted()\fP signal. Depending on \fBQListView::allColumnsShowFocus()\fP this is either the whole item or only the first column. 
.PP
\fBReturns:\fP
.RS 4
true if point is inside execute area of an item, false in all other cases including the case that it is over the viewport. 
.RE
.PP

.PP
Definition at line 460 of file klistview.cpp.
.PP
References QListView::itemAt().
.PP
Referenced by contentsDragMoveEvent(), contentsMouseMoveEvent(), emitExecute(), isExecuteArea(), and slotOnItem().
.SS "bool KListView::isExecuteArea (int x)"
.PP
Same thing, but from an x coordinate only. 
.PP
This only checks if x is in the first column (if all columns don't show focus), without testing if the y coordinate is over an item or not. 
.PP
Definition at line 470 of file klistview.cpp.
.PP
References isExecuteArea().
.SS "\fBQPtrList\fP< \fBQListViewItem\fP > KListView::selectedItems () const"
.PP
\fBReturns:\fP
.RS 4
a list containing the currently selected items.
.RE
.PP
.PP
\fBDeprecated\fP
.RS 4
.RE
.PP

.PP
Definition at line 1205 of file klistview.cpp.
.PP
Referenced by fileManagerKeyPressEvent().
.SS "\fBQPtrList\fP< \fBQListViewItem\fP > KListView::selectedItems (bool includeHiddenItems) const"
.PP
\fBReturns:\fP
.RS 4
a list containing the currently selected items.
.RE
.PP
\fBParameters:\fP
.RS 4
\fIincludeHiddenItems\fP Set to true to return all items regardless of visibility. Set to false to only return items that are isVisible().
.RE
.PP
\fBReturns:\fP
.RS 4
a list of all selected listview items
.RE
.PP
\fBSince:\fP
.RS 4
3.4 
.RE
.PP

.PP
Definition at line 1210 of file klistview.cpp.
.PP
References QPtrList::append(), QListViewItemIterator::current(), QListView::selectedItem(), and QListView::selectionMode().
.SS "void KListView::moveItem (\fBQListViewItem\fP * item, \fBQListViewItem\fP * parent, \fBQListViewItem\fP * after)"
.PP
Arbitrarily move \fCitem\fP to \fCparent\fP, positioned immediately after item \fCafter\fP. 
.PP
If after is 0, \fCitem\fP is made the first child of \fCparent\fP.
.PP
(Un-deprecated in kde-3.4) 
.PP
Definition at line 1247 of file klistview.cpp.
.PP
References QListView::insertItem(), QListViewItem::insertItem(), QListViewItem::moveItem(), QListViewItem::parent(), takeItem(), and QListViewItem::takeItem().
.PP
Referenced by movableDropEvent().
.SS "\fBQListViewItem\fP * KListView::lastItem () const"
.PP
\fBReturns:\fP
.RS 4
the last item (not child!) of this listview.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBlastChild()\fP 
.RE
.PP

.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 1119 of file klistview.cpp.
.PP
References lastChild().
.PP
Referenced by findDrop().
.SS "\fBQListViewItem\fP * KListView::lastChild () const"
.PP
\fBReturns:\fP
.RS 4
the last child of this listview.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBlastItem()\fP 
.RE
.PP

.PP
Definition at line 1109 of file klistview.cpp.
.PP
References QListView::firstChild(), and QListViewItem::nextSibling().
.PP
Referenced by lastItem().
.SS "\fBKLineEdit\fP * KListView::renameLineEdit () const"
.PP
\fBReturns:\fP
.RS 4
the lineedit used for inline renaming. Use that to setup a \fBKCompletion\fP or \fBQValidator\fP for the lineedit
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 1129 of file klistview.cpp.
.SS "bool KListView::itemsMovable () const"
.PP
\fBReturns:\fP
.RS 4
if it is legal to move items in the list view. True by default.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetDragEnabled()\fP 
.PP
\fBsetItemsMovable()\fP 
.RE
.PP

.PP
Referenced by acceptDrag(), and contentsDropEvent().
.SS "bool KListView::itemsRenameable () const"
.PP
\fBReturns:\fP
.RS 4
whether inplace-renaming has been enabled. False by default.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetItemsRenameable()\fP 
.RE
.PP

.SS "bool KListView::dragEnabled () const"
.PP
\fBReturns:\fP
.RS 4
whether dragging is enabled. False by default.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetDragEnabled()\fP 
.RE
.PP

.PP
Referenced by contentsMouseMoveEvent().
.SS "bool KListView::autoOpen () const"
.PP
\fBReturns:\fP
.RS 4
true if AutoOpen is enabled (not implemented currently).
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetAutoOpen()\fP 
.RE
.PP

.SS "bool KListView::isRenameable (int column) const"
.PP
\fBReturns:\fP
.RS 4
true if \fCcolumn\fP is renamable.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetRenameable()\fP 
.RE
.PP

.PP
Definition at line 1370 of file klistview.cpp.
.PP
References QRect::contains().
.SS "bool KListView::dropVisualizer () const"
.PP
\fBReturns:\fP
.RS 4
true if drawing of the drop-visualizer has been enabled. True by default.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetDropVisualizer()\fP 
.RE
.PP

.PP
Referenced by contentsDragMoveEvent().
.SS "int KListView::tooltipColumn () const"
.PP
\fBReturns:\fP
.RS 4
the column for which tooltips are displayed (or -1 if none set).
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetTooltipColumn()\fP 
.RE
.PP

.PP
Referenced by showTooltip().
.SS "bool KListView::createChildren () const"
.PP
For future expansions. 
.PP
Do not use. 
.PP
\fBDeprecated\fP
.RS 4
.RE
.PP

.PP
Definition at line 1400 of file klistview.cpp.
.SS "bool KListView::dropHighlighter () const"
.PP
\fBReturns:\fP
.RS 4
true if drawing of the drop-highlighter has been enabled. False by default.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetDropHighlighter()\fP 
.RE
.PP

.PP
Definition at line 1421 of file klistview.cpp.
.PP
Referenced by contentsDragMoveEvent().
.SS "int KListView::dropVisualizerWidth () const"
.PP
The dropVisualizerWidth defaults to 4. 
.PP
\fBSee also:\fP
.RS 4
\fBsetDropVisualizerWidth()\fP 
.RE
.PP
\fBReturns:\fP
.RS 4
the current width of the drop-visualizer. 
.RE
.PP

.SS "\fBKListView::SelectionModeExt\fP KListView::selectionModeExt () const"
.PP
\fBReturns:\fP
.RS 4
the 'extended' selection mode of this listview.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBSelectionModeExt\fP 
.PP
\fBsetSelectionModeExt\fP 
.RE
.PP

.PP
Definition at line 1836 of file klistview.cpp.
.PP
Referenced by contentsMousePressEvent().
.SS "int KListView::itemIndex (const \fBQListViewItem\fP * item) const"
.PP
Returns the index of \fCitem\fP within the item tree or -1 if \fCitem\fP doesn't exist in this list view. 
.PP
This function takes all items into account not only the visible ones. 
.PP
Definition at line 1841 of file klistview.cpp.
.PP
References QListViewItemIterator::current(), and QListView::firstChild().
.PP
Referenced by slotAutoSelect().
.SS "\fBQListViewItem\fP * KListView::itemAtIndex (int index)"
.PP
Returns the item of \fCindex\fP within the item tree or 0 if \fCindex\fP doesn't exist in this list view. 
.PP
This function takes all items into account not only the visible ones. 
.PP
Definition at line 1860 of file klistview.cpp.
.PP
References QListView::firstChild().
.SS "void KListView::setFullWidth ()"
.PP
\fBDeprecated\fP
.RS 4
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetFullWidth()\fP 
.RE
.PP

.PP
Definition at line 1932 of file klistview.cpp.
.SS "void KListView::setFullWidth (bool fullWidth)"
.PP
Let the last column fit exactly all the available width. 
.PP
\fBSee also:\fP
.RS 4
\fBfullWidth()\fP 
.RE
.PP

.PP
Definition at line 1937 of file klistview.cpp.
.PP
References QListView::columns(), and QListView::header().
.SS "bool KListView::fullWidth () const"
.PP
Returns whether the last column is set to fit the available width. 
.PP
\fBSee also:\fP
.RS 4
\fBsetFullWidth()\fP 
.RE
.PP

.SS "int KListView::addColumn (const \fBQString\fP & label, int width = \fC-1\fP)\fC [virtual]\fP"
.PP
Reimplemented for full width support. 
.PP
\fBSee also:\fP
.RS 4
\fBremoveColumn()\fP 
.RE
.PP

.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 1948 of file klistview.cpp.
.PP
References QListView::addColumn(), QListView::columns(), and QListView::header().
.PP
Referenced by KJanusWidget::KJanusWidget().
.SS "int KListView::addColumn (const \fBQIconSet\fP & iconset, const \fBQString\fP & label, int width = \fC-1\fP)\fC [virtual]\fP"
.PP
Reimplemented for full width support. 
.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 1958 of file klistview.cpp.
.PP
References QListView::addColumn(), QListView::columns(), and QListView::header().
.SS "void KListView::removeColumn (int index)\fC [virtual]\fP"
.PP
Reimplemented for full width support. 
.PP
\fBSee also:\fP
.RS 4
\fBaddColumn()\fP 
.RE
.PP

.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 1968 of file klistview.cpp.
.PP
References QListView::columns(), QListView::header(), and QListView::removeColumn().
.SS "void KListView::setAlternateBackground (const \fBQColor\fP & c)"
.PP
sets the alternate background background color. 
.PP
This only has an effect if the items are KListViewItems
.PP
\fBParameters:\fP
.RS 4
\fIc\fP the color to use for every other item. Set to an invalid color to disable alternate colors.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBalternateBackground()\fP 
.RE
.PP

.PP
Definition at line 1984 of file klistview.cpp.
.SS "const \fBQColor\fP& KListView::alternateBackground () const"
.PP
\fBReturns:\fP
.RS 4
the alternate background color
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetAlternateBackground()\fP 
.RE
.PP

.SS "void KListView::saveLayout (\fBKConfig\fP * config, const \fBQString\fP & group) const"
.PP
Saves the list view's layout (column widtsh, column order, sort column) to a \fBKConfig\fP group. 
.PP
\fBParameters:\fP
.RS 4
\fIconfig\fP the \fBKConfig\fP object to write to 
.br
\fIgroup\fP the config group to use 
.RE
.PP

.PP
Definition at line 2001 of file klistview.cpp.
.PP
References QListView::columns(), QListView::columnWidth(), QListView::header(), QHeader::mapToIndex(), and QString::number().
.SS "void KListView::restoreLayout (\fBKConfig\fP * config, const \fBQString\fP & group)"
.PP
Reads the list view's layout from a \fBKConfig\fP group as stored with saveLayout. 
.PP
\fBParameters:\fP
.RS 4
\fIconfig\fP the \fBKConfig\fP object to read from 
.br
\fIgroup\fP the config group to use 
.RE
.PP

.PP
Definition at line 2019 of file klistview.cpp.
.PP
References QListView::columns(), QListView::header(), QListView::setColumnWidth(), and setSorting().
.SS "void KListView::setSorting (int column, bool ascending = \fCtrue\fP)\fC [virtual]\fP"
.PP
Reimplemented to remember the current sort column and order. 
.PP
\fBParameters:\fP
.RS 4
\fIcolumn\fP is the column to be sorted, or -1 to sort in order of insertion 
.br
\fIascending\fP whether to sort ascending (or descending) 
.RE
.PP

.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 2054 of file klistview.cpp.
.PP
References QListView::ensureItemVisible(), QListView::firstChild(), QListViewItem::isSelected(), QListViewItem::isVisible(), QListViewItem::itemBelow(), KListViewItem::m_known, QListView::selectedItem(), QListView::selectionMode(), and QListView::setSorting().
.PP
Referenced by KJanusWidget::KJanusWidget(), and restoreLayout().
.SS "int KListView::columnSorted (void) const"
.PP
\fBReturns:\fP
.RS 4
the currently sorted column, or -1 if none is sorted 
.RE
.PP

.PP
Definition at line 2087 of file klistview.cpp.
.PP
Referenced by KListViewItem::backgroundColor().
.SS "bool KListView::ascendingSort (void) const"
.PP
\fBReturns:\fP
.RS 4
whether the current sort is ascending (or descending) 
.RE
.PP

.PP
Definition at line 2092 of file klistview.cpp.
.SS "void KListView::takeItem (\fBQListViewItem\fP * i)\fC [virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 2097 of file klistview.cpp.
.PP
References QListView::takeItem().
.PP
Referenced by moveItem().
.SS "void KListView::setShadeSortColumn (bool shadeSortColumn)"
.PP
Set to true if the currently sorted column should be drawn shaded. 
.PP
Defaults to true 
.PP
\fBParameters:\fP
.RS 4
\fIshadeSortColumn\fP True if sort column should be shaded.
.RE
.PP
\fBSince:\fP
.RS 4
3.4 
.RE
.PP

.PP
Definition at line 1990 of file klistview.cpp.
.SS "bool KListView::shadeSortColumn (void) const"
.PP
See if the sort column should be drawn shaded. 
.PP
\fBReturns:\fP
.RS 4
true if the sort column should be shaded
.RE
.PP
\fBSince:\fP
.RS 4
3.4 
.RE
.PP

.SS "void KListView::executed (\fBQListViewItem\fP * item)\fC [signal]\fP"
.PP
This signal is emitted whenever the user executes an listview item. 
.PP
That means depending on the \fBKDE\fP wide Single Click/Double Click setting the user clicked or double clicked on that item. 
.PP
\fBParameters:\fP
.RS 4
\fIitem\fP is the pointer to the executed listview item.
.RE
.PP
Note that you may not delete any \fBQListViewItem\fP objects in slots connected to this signal. 
.PP
Referenced by emitExecute().
.SS "void KListView::executed (\fBQListViewItem\fP * item, const \fBQPoint\fP & pos, int c)\fC [signal]\fP"
.PP
This signal is emitted whenever the user executes an listview item. 
.PP
That means depending on the \fBKDE\fP wide Single Click/Double Click setting the user clicked or double clicked on that item. 
.PP
\fBParameters:\fP
.RS 4
\fIitem\fP is the pointer to the executed listview item. 
.br
\fIpos\fP is the position where the user has clicked 
.br
\fIc\fP is the column into which the user clicked.
.RE
.PP
Note that you may not delete any \fBQListViewItem\fP objects in slots connected to this signal. 
.SS "void KListView::dropped (\fBQDropEvent\fP * e, \fBQListViewItem\fP * after)\fC [signal]\fP"
.PP
This signal gets emitted whenever something acceptable is dropped onto the listview. 
.PP
\fBParameters:\fP
.RS 4
\fIe\fP is the drop event itself (it has already been accepted) 
.br
\fIafter\fP is the item after which the drop occurred (or 0L, if the drop was above all items)
.RE
.PP
\fBSee also:\fP
.RS 4
acceptDrop() 
.RE
.PP

.PP
Reimplemented in \fBKFileTreeView\fP.
.PP
Referenced by contentsDropEvent().
.SS "void KListView::dropped (\fBKListView\fP * list, \fBQDropEvent\fP * e, \fBQListViewItem\fP * after)\fC [signal]\fP"
.PP
This signal gets emitted whenever something acceptable is dropped onto the listview. 
.PP
This is an overloaded version of the above (provided to simplify processing drops outside of the class).
.PP
\fBParameters:\fP
.RS 4
\fIlist\fP is the listview 
.br
\fIe\fP is the drop event itself (it has already been accepted) 
.br
\fIafter\fP is the item after which the drop occurred (or 0L, if the drop was above all items 
.RE
.PP

.SS "void KListView::dropped (\fBKListView\fP * list, \fBQDropEvent\fP * e, \fBQListViewItem\fP * parent, \fBQListViewItem\fP * after)\fC [signal]\fP"
.PP
This signal gets emitted whenever something acceptable is dropped onto the listview. 
.PP
This function also provides a parent, in the event that your listview is a tree 
.PP
\fBParameters:\fP
.RS 4
\fIlist\fP is the listview 
.br
\fIe\fP is the drop event itself (it has already been accepted) 
.br
\fIparent\fP the item that is to be the parent of the new item 
.br
\fIafter\fP is the item after which the drop occurred (or 0L, if the drop was above all items 
.RE
.PP

.SS "void KListView::dropped (\fBQDropEvent\fP * e, \fBQListViewItem\fP * parent, \fBQListViewItem\fP * after)\fC [signal]\fP"
.PP
This signal gets emitted whenever something acceptable is dropped onto the listview. 
.PP
This function also provides a parent, in the event that your listview is a tree 
.PP
\fBParameters:\fP
.RS 4
\fIe\fP is the drop event itself (it has already been accepted) 
.br
\fIparent\fP the item that is to be the parent of the new item 
.br
\fIafter\fP is the item after which the drop occurred (or 0L, if the drop was above all items 
.RE
.PP

.PP
Reimplemented in \fBKFileTreeView\fP.
.SS "void KListView::moved ()\fC [signal]\fP"
.PP
This signal is emitted when ever the user moves an item in the list via DnD. 
.PP
If more than one item is moved at the same time, this signal is only emitted once. 
.PP
Referenced by movableDropEvent(), and startDrag().
.SS "void KListView::aboutToMove ()\fC [signal]\fP"
.PP
Connect to this signal if you want to do some preprocessing before a move is made, for example, to disable sorting. 
.PP
This is sent only once per each groups of moves. That is, for each drop that is a move this will be emitted once, before KListView calls 
.PP
\fBSee also:\fP
.RS 4
\fBmoveItem()\fP 
.RE
.PP

.PP
Referenced by movableDropEvent().
.SS "void KListView::moved (\fBQListViewItem\fP * item, \fBQListViewItem\fP * afterFirst, \fBQListViewItem\fP * afterNow)\fC [signal]\fP"
.PP
This signal is emitted when ever the user moves an item in the list via DnD. 
.PP
If more than one item is moved at the same time, \fCafterFirst\fP and \fCafterNow\fP will reflect what was true before the move. This differs from \fBmoved()\fP, so be careful. All the items will have been moved before \fBmoved()\fP is emitted, which is not true in this method. // FIXME 
.PP
\fBParameters:\fP
.RS 4
\fIitem\fP the item that was moved 
.br
\fIafterFirst\fP the item that parameter item was in before the move, in the list 
.br
\fIafterNow\fP the item it's currently after. 
.RE
.PP

.SS "void KListView::moved (\fBQPtrList\fP< \fBQListViewItem\fP > & items, \fBQPtrList\fP< \fBQListViewItem\fP > & afterFirst, \fBQPtrList\fP< \fBQListViewItem\fP > & afterNow)\fC [signal]\fP"
.PP
This signal is emitted after all the items have been moved. 
.PP
It reports info for each and every item moved, in order. The first element in \fCitems\fP associates with the first of afterFirst and afterNow. 
.SS "void KListView::itemRenamed (\fBQListViewItem\fP * item, const \fBQString\fP & str, int col)\fC [signal]\fP"
.PP
This signal gets emitted when an item is renamed via in-place renaming. 
.PP
\fBParameters:\fP
.RS 4
\fIitem\fP is the renamed item. 
.br
\fIstr\fP is the new value of column \fCcol\fP. 
.br
\fIcol\fP is the renamed column. 
.RE
.PP

.SS "void KListView::itemRenamed (\fBQListViewItem\fP * item)\fC [signal]\fP"
.PP
Same as above, but without the extra information. 
.PP
.SS "void KListView::menuShortCutPressed (\fBKListView\fP * list, \fBQListViewItem\fP * item)\fC [signal]\fP"
.PP
This signal is emitted when the shortcut key for popup-menus is pressed. 
.PP
Normally you should not use this, just connect a slot to signal contextMenu (KListView*, QListViewItem*, const \fBQPoint\fP&) to correctly handle showing context menus regardless of settings.
.PP
\fBParameters:\fP
.RS 4
\fIlist\fP is this listview. 
.br
\fIitem\fP is the \fBcurrentItem()\fP at the time the key was pressed. May be 0L. 
.RE
.PP

.PP
Referenced by keyPressEvent(), and KListView().
.SS "void KListView::contextMenu (\fBKListView\fP * l, \fBQListViewItem\fP * i, const \fBQPoint\fP & p)\fC [signal]\fP"
.PP
This signal is emitted whenever a context-menu should be shown for item \fCi\fP. 
.PP
It automatically adjusts for all settings involved (Menu key, showMenuOnPress/Click).
.PP
\fBParameters:\fP
.RS 4
\fIl\fP is this listview. 
.br
\fIi\fP is the item for which the menu should be shown. May be 0L. 
.br
\fIp\fP is the point at which the menu should be shown. 
.RE
.PP

.PP
Referenced by emitContextMenu().
.SS "void KListView::rename (\fBQListViewItem\fP * item, int c)\fC [virtual, slot]\fP"
.PP
Rename column \fCc\fP of \fCitem\fP. 
.PP
Definition at line 1361 of file klistview.cpp.
.PP
References QListView::ensureItemVisible().
.PP
Referenced by contentsMouseReleaseEvent(), and KListViewLineEdit::selectNextCell().
.SS "void KListView::setRenameable (int column, bool yesno = \fCtrue\fP)\fC [slot]\fP"
.PP
By default, if you called setItemsRenameable(true), only the first column is renameable. 
.PP
Use this function to enable the feature on other columns.
.PP
If you want more intelligent (dynamic) selection, you'll have to derive from KListView, and override \fBrename()\fP and call only call it if you want the item to be renamed. 
.PP
Definition at line 1375 of file klistview.cpp.
.PP
References QListView::header().
.SS "void KListView::setItemsMovable (bool b)\fC [virtual, slot]\fP"
.PP
Set whether items in the list view can be moved. 
.PP
It is enabled by default.
.PP
\fBSee also:\fP
.RS 4
\fBitemsMovable()\fP 
.RE
.PP

.PP
Definition at line 1154 of file klistview.cpp.
.SS "void KListView::setItemsRenameable (bool b)\fC [virtual, slot]\fP"
.PP
Enables inplace-renaming of items. 
.PP
It is disabled by default.
.PP
\fBSee also:\fP
.RS 4
\fBitemsRenameable()\fP 
.PP
\fBsetRenameable()\fP 
.RE
.PP

.PP
Definition at line 1164 of file klistview.cpp.
.SS "void KListView::setDragEnabled (bool b)\fC [virtual, slot]\fP"
.PP
Enable/Disable the dragging of items. 
.PP
It is disabled by default. 
.PP
Definition at line 1175 of file klistview.cpp.
.SS "void KListView::setAutoOpen (bool b)\fC [virtual, slot]\fP"
.PP
Enable/Disable AutoOpen (not implemented currently). 
.PP
Definition at line 1185 of file klistview.cpp.
.SS "void KListView::setDropVisualizer (bool b)\fC [virtual, slot]\fP"
.PP
Enable/Disable the drawing of a drop-visualizer (a bar that shows where a dropped item would be inserted). 
.PP
It is enabled by default, if dragging is enabled 
.PP
Definition at line 1200 of file klistview.cpp.
.SS "void KListView::setDropVisualizerWidth (int w)\fC [slot]\fP"
.PP
Set the width of the (default) drop-visualizer. 
.PP
If you don't call this method, the width is set to 4. 
.PP
Definition at line 1283 of file klistview.cpp.
.SS "void KListView::setTooltipColumn (int column)\fC [virtual, slot]\fP"
.PP
Set which column should be used for automatic tooltips. 
.PP
\fBParameters:\fP
.RS 4
\fIcolumn\fP is the column for which tooltips will be shown. Set -1 to disable this feature. 
.RE
.PP

.PP
Definition at line 1411 of file klistview.cpp.
.SS "void KListView::setDropHighlighter (bool b)\fC [virtual, slot]\fP"
.PP
Enable/Disable the drawing of a drop-highlighter (a rectangle around the item under the mouse cursor). 
.PP
It is disabled by default. 
.PP
Definition at line 1416 of file klistview.cpp.
.SS "void KListView::setCreateChildren (bool b)\fC [virtual, slot]\fP"
.PP
For future expansions. 
.PP
Do not use. 
.PP
\fBDeprecated\fP
.RS 4
.RE
.PP

.PP
Definition at line 1395 of file klistview.cpp.
.SS "void KListView::setSelectionModeExt (\fBSelectionModeExt\fP mode)\fC [slot]\fP"
.PP
Set the selection mode. 
.PP
A different name was chosen to avoid API-clashes with \fBQListView::setSelectionMode()\fP. 
.PP
Definition at line 1813 of file klistview.cpp.
.PP
References endl(), kdWarning(), and QListView::setSelectionMode().
.SS "void KListView::setTabOrderedRenaming (bool b)\fC [slot]\fP"
.PP
Enable/disable tabbing between editable cells 
.PP
\fBSince:\fP
.RS 4
3.1. 
.RE
.PP

.PP
Definition at line 1436 of file klistview.cpp.
.SS "bool KListView::tabOrderedRenaming () const\fC [slot]\fP"
.PP
Returns whether tab ordered renaming is enabled 
.PP
\fBSince:\fP
.RS 4
3.1. 
.RE
.PP

.PP
Definition at line 1441 of file klistview.cpp.
.SS "bool KListView::below (const \fBQRect\fP & rect, const \fBQPoint\fP & p)\fC [inline, protected]\fP"
.PP
Determine whether a drop on position \fCp\fP would count as being above or below the \fBQRect\fP \fCrect\fP. 
.PP
\fBParameters:\fP
.RS 4
\fIrect\fP is the rectangle we examine. 
.br
\fIp\fP is the point located in the rectangle, p is assumed to be in viewport coordinates. 
.RE
.PP

.PP
Definition at line 671 of file klistview.h.
.SS "bool KListView::below (\fBQListViewItem\fP * i, const \fBQPoint\fP & p)\fC [inline, protected]\fP"
.PP
An overloaded version of \fBbelow(const QRect&, const QPoint&)\fP. 
.PP
It differs from the above only in what arguments it takes.
.PP
\fBParameters:\fP
.RS 4
\fIi\fP the item whose rect() is passed to the above function. 
.br
\fIp\fP is translated from contents coordinates to viewport coordinates before being passed to the above function. 
.RE
.PP

.PP
Definition at line 685 of file klistview.h.
.PP
References QListView::itemRect().
.SS "bool KListView::event (\fBQEvent\fP *)\fC [protected, virtual]\fP"
.PP
Reimplemented to reload the alternate background in palette changes. 
.PP
Definition at line 738 of file klistview.cpp.
.PP
References KGlobalSettings::alternateBackgroundColor().
.PP
Referenced by contentsDragEnterEvent(), and contentsDragMoveEvent().
.SS "void KListView::emitExecute (\fBQListViewItem\fP * item, const \fBQPoint\fP & pos, int c)\fC [protected]\fP"
.PP
Emit signal executed. 
.PP
Definition at line 665 of file klistview.cpp.
.PP
References executed(), isExecuteArea(), and KApplication::keyboardMouseState().
.PP
Referenced by contentsMouseDoubleClickEvent().
.SS "void KListView::focusInEvent (\fBQFocusEvent\fP * fe)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Definition at line 693 of file klistview.cpp.
.PP
References QListView::currentItem(), and QListView::selectionChanged().
.SS "void KListView::focusOutEvent (\fBQFocusEvent\fP * fe)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Definition at line 709 of file klistview.cpp.
.PP
References cleanDropVisualizer(), cleanItemHighlighter(), QListView::currentItem(), and QListView::selectionChanged().
.SS "void KListView::leaveEvent (\fBQEvent\fP * e)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Definition at line 731 of file klistview.cpp.
.SS "\fBQString\fP KListView::tooltip (\fBQListViewItem\fP * item, int column) const\fC [protected, virtual]\fP"
.PP
\fBReturns:\fP
.RS 4
the tooltip for \fCcolumn\fP of \fCitem\fP. 
.RE
.PP

.PP
Definition at line 1431 of file klistview.cpp.
.PP
Referenced by showTooltip().
.SS "bool KListView::showTooltip (\fBQListViewItem\fP * item, const \fBQPoint\fP & pos, int column) const\fC [protected, virtual]\fP"
.PP
\fBReturns:\fP
.RS 4
whether the tooltip for \fCcolumn\fP of \fCitem\fP shall be shown at point \fCpos\fP. 
.RE
.PP

.PP
Definition at line 1426 of file klistview.cpp.
.PP
References tooltip(), and tooltipColumn().
.SS "void KListView::contentsDragMoveEvent (\fBQDragMoveEvent\fP * event)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Reimplemented in \fBKFileDetailView\fP, and \fBKFileTreeView\fP.
.PP
Definition at line 968 of file klistview.cpp.
.PP
References acceptDrag(), cleanDropVisualizer(), cleanItemHighlighter(), drawDropVisualizer(), drawItemHighlighter(), dropHighlighter(), dropVisualizer(), event(), findDrop(), isExecuteArea(), and QListView::itemAt().
.SS "void KListView::contentsMousePressEvent (\fBQMouseEvent\fP * e)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 746 of file klistview.cpp.
.PP
References QListView::clearSelection(), QListView::contentsMousePressEvent(), QListView::currentItem(), QListViewItem::depth(), QListView::header(), QListViewItem::isSelected(), QListView::itemAt(), QListView::itemMargin(), QListView::rootIsDecorated(), selectionModeExt(), and QListView::treeStepSize().
.SS "void KListView::contentsMouseMoveEvent (\fBQMouseEvent\fP * e)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 793 of file klistview.cpp.
.PP
References QListView::contentsMouseMoveEvent(), QListView::contentsMouseReleaseEvent(), dragEnabled(), isExecuteArea(), QListView::itemAt(), startDrag(), QPoint::x(), and QPoint::y().
.SS "void KListView::contentsMouseDoubleClickEvent (\fBQMouseEvent\fP * e)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 866 of file klistview.cpp.
.PP
References doubleClicked(), QListView::doubleClicked(), emitExecute(), QListView::header(), QListView::itemAt(), and QPoint::x().
.SS "void KListView::contentsDragLeaveEvent (\fBQDragLeaveEvent\fP * event)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Reimplemented in \fBKFileDetailView\fP, and \fBKFileTreeView\fP.
.PP
Definition at line 1018 of file klistview.cpp.
.PP
References cleanDropVisualizer(), and cleanItemHighlighter().
.SS "void KListView::contentsMouseReleaseEvent (\fBQMouseEvent\fP *)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 833 of file klistview.cpp.
.PP
References QListView::contentsMouseReleaseEvent(), QListViewItem::depth(), QListView::header(), QListView::itemAt(), QListView::itemMargin(), rename(), QListView::rootIsDecorated(), and QListView::treeStepSize().
.SS "void KListView::contentsDropEvent (\fBQDropEvent\fP *)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Reimplemented in \fBKFileDetailView\fP, and \fBKFileTreeView\fP.
.PP
Definition at line 892 of file klistview.cpp.
.PP
References acceptDrag(), cleanDropVisualizer(), cleanItemHighlighter(), dropped(), findDrop(), itemsMovable(), and movableDropEvent().
.SS "void KListView::contentsDragEnterEvent (\fBQDragEnterEvent\fP *)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Reimplemented in \fBKFileDetailView\fP, and \fBKFileTreeView\fP.
.PP
Definition at line 1277 of file klistview.cpp.
.PP
References acceptDrag(), and event().
.SS "\fBQDragObject\fP * KListView::dragObject ()\fC [protected, virtual]\fP"
.PP
\fBReturns:\fP
.RS 4
a dragobject encoding the current selection.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetDragEnabled()\fP 
.RE
.PP

.PP
Reimplemented from \fBQListView\fP.
.PP
Reimplemented in \fBKFileDetailView\fP, and \fBKFileTreeView\fP.
.PP
Definition at line 1145 of file klistview.cpp.
.PP
References QListView::currentItem().
.PP
Referenced by startDrag().
.SS "bool KListView::acceptDrag (\fBQDropEvent\fP * event) const\fC [protected, virtual]\fP"
.PP
\fBReturns:\fP
.RS 4
true if the \fCevent\fP provides some acceptable format. A common mistake is to forget the 'const' in your reimplementation 
.RE
.PP

.PP
Reimplemented in \fBKFileDetailView\fP, and \fBKFileTreeView\fP.
.PP
Definition at line 1390 of file klistview.cpp.
.PP
References itemsMovable().
.PP
Referenced by contentsDragEnterEvent(), contentsDragMoveEvent(), and contentsDropEvent().
.SS "\fBQRect\fP KListView::drawDropVisualizer (\fBQPainter\fP * p, \fBQListViewItem\fP * parent, \fBQListViewItem\fP * after)\fC [protected, virtual]\fP"
.PP
Paint the drag line. 
.PP
If painter is null, don't try to :)
.PP
If after == 0 then the marker should be drawn at the top.
.PP
\fBReturns:\fP
.RS 4
the rectangle that you painted to. 
.RE
.PP

.PP
Definition at line 1288 of file klistview.cpp.
.PP
References QRect::bottom(), QListViewItem::firstChild(), QListView::itemMargin(), QListView::itemRect(), QListViewItem::nextSibling(), QListView::rootIsDecorated(), QRect::setBottom(), QRect::setLeft(), QRect::setRight(), QRect::setTop(), and QListView::treeStepSize().
.PP
Referenced by contentsDragMoveEvent().
.SS "\fBQRect\fP KListView::drawItemHighlighter (\fBQPainter\fP * painter, \fBQListViewItem\fP * item)\fC [protected, virtual]\fP"
.PP
Paint the drag rectangle. 
.PP
If painter is null, don't try to :)
.PP
\fBReturns:\fP
.RS 4
the rectangle that you painted to. 
.RE
.PP

.PP
Definition at line 1335 of file klistview.cpp.
.PP
References QListView::itemRect(), QRect::left(), QListView::rootIsDecorated(), QRect::setLeft(), and QListView::treeStepSize().
.PP
Referenced by contentsDragMoveEvent().
.SS "void KListView::startDrag ()\fC [protected, virtual]\fP"
.PP
This method calls \fBdragObject()\fP and starts the drag. 
.PP
Reimplement it to do fancy stuff like setting a pixmap or using a non-default DragMode 
.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 1134 of file klistview.cpp.
.PP
References QDragObject::drag(), dragObject(), moved(), and QDragObject::target().
.PP
Referenced by contentsMouseMoveEvent().
.SS "void KListView::keyPressEvent (\fBQKeyEvent\fP *)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Reimplemented in \fBKFileDetailView\fP.
.PP
Definition at line 1446 of file klistview.cpp.
.PP
References QListView::currentItem(), fileManagerKeyPressEvent(), and menuShortCutPressed().
.SS "void KListView::viewportPaintEvent (\fBQPaintEvent\fP *)\fC [protected, virtual]\fP"
.PP
Reimplemented for internal reasons. 
.PP
Further reimplementations should call this function or else some features may not work correctly.
.PP
The API is unaffected. 
.PP
Definition at line 1905 of file klistview.cpp.
.PP
References QPainter::fillRect().
.SS "void KListView::activateAutomaticSelection ()\fC [protected]\fP"
.PP
In FileManager selection mode: explicitly activate the mode in which the current item is automatically selected. 
.PP
Definition at line 1461 of file klistview.cpp.
.PP
References QListView::currentItem(), and QListView::selectionChanged().
.SS "void KListView::deactivateAutomaticSelection ()\fC [protected]\fP"
.PP
In FileManager selection mode: explicitly deactivate the mode in which the current item is automatically selected. 
.PP
Definition at line 1473 of file klistview.cpp.
.SS "bool KListView::automaticSelection () const\fC [protected]\fP"
.PP
In FileManager selection mode: return whether it is currently in the mode where the current item is selected automatically. 
.PP
Returns false if items were selected explicitly, e.g. using the mouse. 
.PP
Definition at line 1478 of file klistview.cpp.
.SS "void KListView::viewportResizeEvent (\fBQResizeEvent\fP * e)\fC [protected, virtual]\fP"
.PP
Reimplemented for \fBsetFullWidth()\fP. 
.PP
Definition at line 1974 of file klistview.cpp.
.SS "void KListView::disableAutoSelection ()\fC [protected]\fP"
.PP
Disable AutoSelection. 
.PP
This overrides the system wide setting for AutoSelection. Please don't call this unless you have good reasons to override the system wide setting for AutoSelection. 
.PP
\fBSee also:\fP
.RS 4
\fBresetAutoSelection()\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2105 of file klistview.cpp.
.SS "void KListView::resetAutoSelection ()\fC [protected]\fP"
.PP
Reset AutoSelection to the system wide setting. 
.PP
\fBSee also:\fP
.RS 4
\fBdisableAutoSelection()\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2115 of file klistview.cpp.
.PP
References KGlobalSettings::autoSelectDelay().
.SS "void KListView::doubleClicked (\fBQListViewItem\fP * item, const \fBQPoint\fP & pos, int c)\fC [protected]\fP"
.PP
\fBDeprecated\fP
.RS 4
This is just here for binary compatibility. Use the signal in \fBQListView\fP instead. 
.RE
.PP

.PP
Reimplemented from \fBQListView\fP.
.PP
Definition at line 2124 of file klistview.cpp.
.PP
References QListView::doubleClicked().
.PP
Referenced by contentsMouseDoubleClickEvent().
.SS "void KListView::slotSettingsChanged (int)\fC [protected, slot]\fP"
.PP
Update internal settings whenever the global ones change. 
.PP
Definition at line 527 of file klistview.cpp.
.PP
References KGlobalSettings::autoSelectDelay(), KGlobalSettings::changeCursorOverIcon(), KGlobalSettings::contextMenuKey(), KGlobalSettings::dndEventDelay(), emitContextMenu(), KGlobalSettings::showContextMenusOnPress(), and KGlobalSettings::singleClick().
.PP
Referenced by KListView().
.SS "void KListView::cleanDropVisualizer ()\fC [protected, slot]\fP"
.PP
Repaint the rect where I was drawing the drop line. 
.PP
Definition at line 1025 of file klistview.cpp.
.PP
Referenced by contentsDragLeaveEvent(), contentsDragMoveEvent(), contentsDropEvent(), focusOutEvent(), and KListView().
.SS "void KListView::cleanItemHighlighter ()\fC [protected, slot]\fP"
.PP
Repaint the rect where I was drawing the drop rectangle. 
.PP
Definition at line 1351 of file klistview.cpp.
.PP
Referenced by contentsDragLeaveEvent(), contentsDragMoveEvent(), contentsDropEvent(), focusOutEvent(), and KListView().
.SS "void KListView::emitContextMenu (\fBQListViewItem\fP *, const \fBQPoint\fP &, int)\fC [protected, slot]\fP"
.PP
Emit the contextMenu signal. 
.PP
This slot is for mouse actions. 
.PP
Definition at line 1888 of file klistview.cpp.
.PP
References contextMenu().
.PP
Referenced by KListView(), and slotSettingsChanged().
.SS "void KListView::emitContextMenu (\fBKListView\fP *, \fBQListViewItem\fP *)\fC [protected, slot]\fP"
.PP
Emit the contextMenu signal. 
.PP
This slot is for key presses. 
.PP
Definition at line 1876 of file klistview.cpp.
.PP
References contextMenu(), and QListView::itemRect().
.SS "void KListView::slotOnItem (\fBQListViewItem\fP * item)\fC [protected, slot]\fP"
.PP
Accessory slot for AutoSelect. 
.PP
Definition at line 509 of file klistview.cpp.
.PP
References isExecuteArea(), and QPoint::x().
.PP
Referenced by KListView().
.SS "void KListView::slotOnViewport ()\fC [protected, slot]\fP"
.PP
Accessory slot for AutoSelect/ChangeCursorOverItem. 
.PP
Definition at line 518 of file klistview.cpp.
.PP
Referenced by KListView().
.SS "void KListView::slotAutoSelect ()\fC [protected, slot]\fP"
.PP
Process AutoSelection. 
.PP
Definition at line 576 of file klistview.cpp.
.PP
References QListView::clearSelection(), QListView::currentItem(), endl(), itemIndex(), QListViewItem::itemPos(), kdDebug(), KApplication::keyboardMouseState(), QListView::selectionChanged(), QListView::selectionMode(), QListView::setCurrentItem(), QListView::setSelected(), QListViewItem::setSelected(), and QListView::triggerUpdate().
.PP
Referenced by KListView().
.SS "void KListView::slotHeaderChanged ()\fC [protected, slot]\fP"
.PP
Reacts to header changes in full width mode. 
.PP
Definition at line 652 of file klistview.cpp.
.PP
References QListView::columns(), QListView::columnWidth(), and QListView::setColumnWidth().
.SS "void KListView::movableDropEvent (\fBQListViewItem\fP * parent, \fBQListViewItem\fP * afterme)\fC [protected, virtual]\fP"
.PP
Handle dropEvent when \fBitemsMovable()\fP is set to true. 
.PP
Definition at line 918 of file klistview.cpp.
.PP
References aboutToMove(), QPtrList::append(), QListView::clearSelection(), QListView::currentItem(), QPtrList::first(), QListView::firstChild(), QListViewItem::itemAbove(), QListViewItem::itemBelow(), moved(), moveItem(), QPtrList::next(), QListView::setCurrentItem(), and QListViewItem::setSelected().
.PP
Referenced by contentsDropEvent().
.SS "void KListView::findDrop (const \fBQPoint\fP & pos, \fBQListViewItem\fP *& parent, \fBQListViewItem\fP *& after)\fC [protected, virtual]\fP"
.PP
Where is the nearest \fBQListViewItem\fP that I'm going to drop? 
.PP
FIXME \fBKDE\fP 4.0: Make this method const so it can be called from an acceptDrag method without ugly casts 
.PP
Definition at line 1040 of file klistview.cpp.
.PP
References QListViewItem::childCount(), QListViewItem::depth(), depthToPixels(), QListViewItem::firstChild(), QListViewItem::height(), QListViewItem::isExpandable(), QListViewItem::isOpen(), QListViewItem::itemAbove(), QListView::itemAt(), QListView::itemRect(), lastItem(), QListViewItem::nextSibling(), QListViewItem::parent(), QPoint::x(), and QPoint::y().
.PP
Referenced by contentsDragMoveEvent(), and contentsDropEvent().
.SS "void KListView::fileManagerKeyPressEvent (\fBQKeyEvent\fP *)\fC [protected]\fP"
.PP
A special keyPressEvent (for FileManager selection mode). 
.PP
Definition at line 1483 of file klistview.cpp.
.PP
References QListViewItem::childCount(), QListView::currentItem(), QListView::ensureItemVisible(), QListView::firstChild(), QListViewItem::height(), QRect::isEmpty(), QListViewItem::isExpandable(), QListViewItem::isOpen(), QListViewItem::isSelected(), QListViewItem::itemAbove(), QListViewItem::itemBelow(), QListView::itemRect(), QRect::moveBy(), QListView::selectAll(), selectedItems(), QListView::selectionChanged(), QListView::selectionMode(), QListView::setCurrentItem(), QListView::setOpen(), QListViewItem::setSelected(), QListView::setSelectionMode(), QRect::unite(), and QRect::x().
.PP
Referenced by keyPressEvent().
.SS "int KListView::depthToPixels (int depth)\fC [protected]\fP"
.PP
Convert the depth of an item into its indentation in pixels. 
.PP
Definition at line 1035 of file klistview.cpp.
.PP
References QListView::itemMargin(), QListView::rootIsDecorated(), and QListView::treeStepSize().
.PP
Referenced by findDrop().

.SH "Author"
.PP 
Generated automatically by Doxygen for kdeui Library from the source code.
