---

KListView Class Reference

#include <klistview.h>

Inheritance diagram for KListView:

List of all members.

Public Types
enum	SelectionModeExt
Public Slots
virtual void	rename (QListViewItem *item, int c)
void	setRenameable (int column, bool yesno=true)
virtual void	setItemsMovable (bool b)
virtual void	setItemsRenameable (bool b)
virtual void	setDragEnabled (bool b)
virtual void	setAutoOpen (bool b)
virtual void	setDropVisualizer (bool b)
void	setDropVisualizerWidth (int w)
virtual void	setTooltipColumn (int column)
virtual void	setDropHighlighter (bool b)
virtual void	setCreateChildren (bool b)
void	setSelectionModeExt (SelectionModeExt mode)
void	setTabOrderedRenaming (bool b)
bool	tabOrderedRenaming () const
Signals
void	executed (QListViewItem *item)
void	executed (QListViewItem *item, const QPoint &pos, int c)
void	doubleClicked (QListViewItem *item, const QPoint &pos, int c)
void	dropped (QDropEvent *e, QListViewItem *after)
void	dropped (KListView *list, QDropEvent *e, QListViewItem *after)
void	dropped (KListView *list, QDropEvent *e, QListViewItem *parent, QListViewItem *after)
void	dropped (QDropEvent *e, QListViewItem *parent, QListViewItem *after)
void	moved ()
void	aboutToMove ()
void	moved (QListViewItem *item, QListViewItem *afterFirst, QListViewItem *afterNow)
void	moved (QPtrList< QListViewItem > &items, QPtrList< QListViewItem > &afterFirst, QPtrList< QListViewItem > &afterNow)
void	itemRenamed (QListViewItem *item, const QString &str, int col)
void	itemRenamed (QListViewItem *item)
void	menuShortCutPressed (KListView *list, QListViewItem *item)
void	contextMenu (KListView *l, QListViewItem *i, const QPoint &p)
Public Methods
	KListView (QWidget *parent=0, const char *name=0)
virtual	~KListView ()
virtual void	setAcceptDrops (bool)
virtual bool	isExecuteArea (const QPoint &point)
bool	isExecuteArea (int x)
QPtrList< QListViewItem >	selectedItems () const
void	moveItem (QListViewItem *item, QListViewItem *parent, QListViewItem *after)
QListViewItem *	lastItem () const
QListViewItem *	lastChild () const
KLineEdit *	renameLineEdit () const
bool	itemsMovable () const
bool	itemsRenameable () const
bool	dragEnabled () const
bool	autoOpen () const
bool	isRenameable (int column) const
bool	dropVisualizer () const
int	tooltipColumn () const
bool	createChildren () const
bool	dropHighlighter () const
int	dropVisualizerWidth () const
SelectionModeExt	selectionModeExt () const
int	itemIndex (const QListViewItem *item) const
QListViewItem *	itemAtIndex (int index)
void	setFullWidth ()
void	setFullWidth (bool fullWidth)
bool	fullWidth () const
virtual int	addColumn (const QString &label, int width=-1)
virtual int	addColumn (const QIconSet &iconset, const QString &label, int width=-1)
virtual void	removeColumn (int index)
void	setAlternateBackground (const QColor &c)
const QColor &	alternateBackground () const
void	saveLayout (KConfig *config, const QString &group) const
void	restoreLayout (KConfig *config, const QString &group)
virtual void	setSorting (int column, bool ascending=true)
int	columnSorted (void) const
bool	ascendingSort (void) const
Protected Slots
void	slotSettingsChanged (int)
void	cleanDropVisualizer ()
void	cleanItemHighlighter ()
void	emitContextMenu (QListViewItem *, const QPoint &, int)
void	emitContextMenu (KListView *, QListViewItem *)
void	slotOnItem (QListViewItem *item)
void	slotOnViewport ()
void	slotAutoSelect ()
void	slotHeaderChanged ()
Protected Methods
bool	below (const QRect &rect, const QPoint &p)
bool	below (QListViewItem *i, const QPoint &p)
virtual bool	event (QEvent *)
void	emitExecute (QListViewItem *item, const QPoint &pos, int c)
virtual void	focusInEvent (QFocusEvent *fe)
virtual void	focusOutEvent (QFocusEvent *fe)
virtual void	leaveEvent (QEvent *e)
virtual QString	tooltip (QListViewItem *item, int column) const
virtual bool	showTooltip (QListViewItem *item, const QPoint &pos, int column) const
virtual void	contentsDragMoveEvent (QDragMoveEvent *event)
virtual void	contentsMousePressEvent (QMouseEvent *e)
virtual void	contentsMouseMoveEvent (QMouseEvent *e)
virtual void	contentsMouseDoubleClickEvent (QMouseEvent *e)
virtual void	contentsDragLeaveEvent (QDragLeaveEvent *event)
virtual void	contentsMouseReleaseEvent (QMouseEvent *)
virtual void	contentsDropEvent (QDropEvent *)
virtual void	contentsDragEnterEvent (QDragEnterEvent *)
virtual QDragObject *	dragObject ()
virtual bool	acceptDrag (QDropEvent *event) const
virtual QRect	drawDropVisualizer (QPainter *p, QListViewItem *parent, QListViewItem *after)
virtual QRect	drawItemHighlighter (QPainter *painter, QListViewItem *item)
virtual void	startDrag ()
virtual void	keyPressEvent (QKeyEvent *)
virtual void	viewportPaintEvent (QPaintEvent *)
void	activateAutomaticSelection ()
void	deactivateAutomaticSelection ()
bool	automaticSelection () const
virtual void	viewportResizeEvent (QResizeEvent *e)
virtual void	movableDropEvent (QListViewItem *parent, QListViewItem *afterme)
virtual void	findDrop (const QPoint &pos, QListViewItem *&parent, QListViewItem *&after)
void	fileManagerKeyPressEvent (QKeyEvent *)
int	depthToPixels (int depth)

---

Detailed Description

This Widget extends the functionality of QListView to honor the system wide settings for Single Click/Double Click mode, AutoSelection and ChangeCursorOverLink (TM).

There is a new signal executed(). It gets connected to either QListView::clicked() or QListView::doubleClicked() depending on the KDE 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 QListView::selectionChanged() signal.

Drag-and-Drop is supported with the signal dropped(), 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*)

KListView is drag-enabled, too: to benefit from that you've got derive from it. Reimplement dragObject() and (possibly) startDrag(), and setDragEnabled(true).

Version:

Id:

klistview.h,v 1.92.2.2 2003/07/20 12:27:11 cniehaus Exp

Definition at line 54 of file klistview.h.

---

Member Enumeration Documentation

enum KListView::SelectionModeExt

Possible selection modes. The first four correspond directly to QListView::SelectionMode, while the FileManager selection mode is defined as follows: home: move to the first end: move to the last PgUp/PgDn: move one page up/down up/down: move one item up/down insert: toggle selection of current and move to the next space: toggle selection of the current CTRL+up: move to the previous item and toggle selection of this one CTRL+down: toggle selection of the current item and move to the next CTRL+end: toggle selection from (including) the current item to (including) the last item CTRL+home: toggle selection from (including) the current item to the (including) the first item CTRL+PgDn: toggle selection from (including) the current item to (excluding) the item one page down CTRL+PgUp: toggle selection from (excluding) the current item to (including) the item one page up 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. Additionally the current item is always selected automatically when navigating using the keyboard, except other items were selected explicitely. This way e.g. SHIFT+up/PgUp then SHIFT+down/PgDn leaves no item selected Definition at line 93 of file klistview.h.

---

Constructor & Destructor Documentation

KListView::KListView (  QWidget *    parent = 0, const char *    name = 0 )

Constructor. The parameters parent and name are handled by QListView, as usual.

virtual KListView::~KListView (    )  [virtual]

Destructor.

---

Member Function Documentation

void KListView::aboutToMove (    )  [signal]

Connect to this signal if you want to do some preprocessing before a move is made, for example, to disable sorting 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 moveItem()

virtual bool KListView::acceptDrag (  QDropEvent *    event )  const [protected, virtual]

Returns: true if the event provides some acceptable format. A common mistake is to forget the "const" in your reimplementation Reimplemented in KFileTreeView.

void KListView::activateAutomaticSelection (    )  [protected]

In FileManager selection mode: explicitely activate the mode in which the current item is automatically selected.

virtual int KListView::addColumn (  const QIconSet &    iconset, const QString &    label, int    width = -1 )  [virtual]

Reimplemented for full width support

virtual int KListView::addColumn (  const QString &    label, int    width = -1 )  [virtual]

Reimplemented for full width support

const QColor& KListView::alternateBackground (    )

Returns: the alternate background color

bool KListView::ascendingSort (  void    )  const

Returns: whether the current sort is ascending (or descending)

bool KListView::automaticSelection (    )  [protected]

In FileManager selection mode: return whether it is currently in the mode where the current item is selected automatically. Returns false if items were selected explicitely, e.g. using the mouse.

bool KListView::autoOpen (    )

Returns: true if AutoOpen is enabled (not implemented currently). See also: setAutoOpen()

bool KListView::below (  QListViewItem *    i, const QPoint &    p )  [inline, protected]

An overloaded version of below(const QRect&, const QPoint&). It differs from the above only in what arguments it takes. Parameters: i  the item whose rect() is passed to the above function. p  is translated from contents coordinates to viewport coordinates before being passed to the above function. Definition at line 614 of file klistview.h. References below().

bool KListView::below (  const QRect &    rect, const QPoint &    p )  [inline, protected]

Determine whether a drop on position p would count as being above or below the QRect rect. Parameters: rect  is the rectangle we examine. p  is the point located in the rectangle, p is assumed to be in viewport coordinates. Definition at line 600 of file klistview.h. Referenced by below().

void KListView::cleanDropVisualizer (    )  [protected, slot]

Repaint the rect where I was drawing the drop line.

void KListView::cleanItemHighlighter (    )  [protected, slot]

Repaint the rect where I was drawing the drop rectangle.

int KListView::columnSorted (  void    )  const

Returns: the currently sorted column, or -1 if none is sorted

virtual void KListView::contentsDragEnterEvent (  QDragEnterEvent *    )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected. Reimplemented in KFileTreeView.

virtual void KListView::contentsDragLeaveEvent (  QDragLeaveEvent *    event )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected. Reimplemented in KFileTreeView.

virtual void KListView::contentsDragMoveEvent (  QDragMoveEvent *    event )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected. Reimplemented in KFileTreeView.

virtual void KListView::contentsDropEvent (  QDropEvent *    )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected. Reimplemented in KFileTreeView.

virtual void KListView::contentsMouseDoubleClickEvent (  QMouseEvent *    e )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

virtual void KListView::contentsMouseMoveEvent (  QMouseEvent *    e )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

virtual void KListView::contentsMousePressEvent (  QMouseEvent *    e )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

virtual void KListView::contentsMouseReleaseEvent (  QMouseEvent *    )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

void KListView::contextMenu (  KListView *    l, QListViewItem *    i, const QPoint &    p )  [signal]

This signal is emitted whenever a context-menu should be shown for item i. It automatically adjusts for all settings involved (Menu key, showMenuOnPress/Click). Parameters: l  is this listview. i  is the item for which the menu should be shown. May be 0L. p  is the point at which the menu should be shown.

bool KListView::createChildren (    )

For future expansions. Do not use. Deprecated:

void KListView::deactivateAutomaticSelection (    )  [protected]

In FileManager selection mode: explicitely deactivate the mode in which the current item is automatically selected.

int KListView::depthToPixels (  int    depth )  [protected]

Convert the depth of an item into its indentation in pixels

void KListView::doubleClicked (  QListViewItem *    item, const QPoint &    pos, int    c )  [signal]

This signal gets emitted whenever the user double clicks into the listview. Parameters: item  is the pointer to the clicked listview item. pos  is the position where the user has clicked, and c  is the column into which the user clicked. Note that you may not delete any QListViewItem objects in slots connected to this signal. This signal is more or less here for the sake of completeness. You should normally not need to use this. In most cases it´s better to use executed() instead.

bool KListView::dragEnabled (    )

Returns: whether dragging is enabled.

virtual QDragObject* KListView::dragObject (    )  [protected, virtual]

Returns: a dragobject encoding the current selection. See also: setDragEnabled() Reimplemented in KFileTreeView.

virtual QRect KListView::drawDropVisualizer (  QPainter *    p, QListViewItem *    parent, QListViewItem *    after )  [protected, virtual]

Paint the drag line. If painter is null, don't try to :) If after == 0 then the marker should be drawn at the top. Returns: the rectangle that you painted to.

virtual QRect KListView::drawItemHighlighter (  QPainter *    painter, QListViewItem *    item )  [protected, virtual]

Paint the drag rectangle. If painter is null, don't try to :) Returns: the rectangle that you painted to.

bool KListView::dropHighlighter (    )

Returns: true if drawing of the drop-highlighter has been enabled.

void KListView::dropped (  QDropEvent *    e, QListViewItem *    parent, QListViewItem *    after )  [signal]

This signal gets emitted whenever something acceptable is dropped onto the listview. This function also provides a parent, in the event that your listview is a tree Parameters: e  is the drop event itself (it has already been accepted) parent  the item that is to be the parent of the new item after  is the item after which the drop occured (or 0L, if the drop was above all items Reimplemented in KFileTreeView.

void KListView::dropped (  KListView *    list, QDropEvent *    e, QListViewItem *    parent, QListViewItem *    after )  [signal]

This signal gets emitted whenever something acceptable is dropped onto the listview. This function also provides a parent, in the event that your listview is a tree Parameters: list  is the listview e  is the drop event itself (it has already been accepted) parent  the item that is to be the parent of the new item after  is the item after which the drop occured (or 0L, if the drop was above all items

void KListView::dropped (  KListView *    list, QDropEvent *    e, QListViewItem *    after )  [signal]

This signal gets emitted whenever something acceptable is dropped onto the listview. This is an overloaded version of the above (provided to simplify processing drops outside of the class). Parameters: list  is the listview e  is the drop event itself (it has already been accepted) after  is the item after which the drop occured (or 0L, if the drop was above all items

void KListView::dropped (  QDropEvent *    e, QListViewItem *    after )  [signal]

This signal gets emitted whenever something acceptable is dropped onto the listview. Parameters: e  is the drop event itself (it has already been accepted) after  is the item after which the drop occured (or 0L, if the drop was above all items) See also: acceptDrop() Reimplemented in KFileTreeView.

bool KListView::dropVisualizer (    )

Returns: true if drawing of the drop-visualizer has been enabled.

int KListView::dropVisualizerWidth (    )

The dropVisualizerWidth defaults to 4. Returns: the current width of the drop-visualizer.

void KListView::emitContextMenu (  KListView *   , QListViewItem *    )  [protected, slot]

Emit the contextMenu signal. This slot is for key presses.

void KListView::emitContextMenu (  QListViewItem *   , const QPoint &   , int    )  [protected, slot]

Emit the contextMenu signal. This slot is for mouse actions.

void KListView::emitExecute (  QListViewItem *    item, const QPoint &    pos, int    c )  [protected]

Emit signal executed.

virtual bool KListView::event (  QEvent *    )  [protected, virtual]

Reimplemented to reload the alternate background in palette changes.

void KListView::executed (  QListViewItem *    item, const QPoint &    pos, int    c )  [signal]

This signal is emitted whenever the user executes an listview item. That means depending on the KDE wide Single Click/Double Click setting the user clicked or double clicked on that item. Parameters: item  is the pointer to the executed listview item. pos  is the position where the user has clicked c  is the column into which the user clicked. Note that you may not delete any QListViewItem objects in slots connected to this signal.

void KListView::executed (  QListViewItem *    item )  [signal]

This signal is emitted whenever the user executes an listview item. That means depending on the KDE wide Single Click/Double Click setting the user clicked or double clicked on that item. Parameters: item  is the pointer to the executed listview item. Note that you may not delete any QListViewItem objects in slots connected to this signal.

void KListView::fileManagerKeyPressEvent (  QKeyEvent *    )  [protected]

A special keyPressEvent (for FileManager selection mode).

virtual void KListView::findDrop (  const QPoint &    pos, QListViewItem *&    parent, QListViewItem *&    after )  [protected, virtual]

Where is the nearest QListViewItem that I'm going to drop?

virtual void KListView::focusInEvent (  QFocusEvent *    fe )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

virtual void KListView::focusOutEvent (  QFocusEvent *    fe )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

bool KListView::fullWidth (    )

Returns whether the last column is set to fit the available width.

bool KListView::isExecuteArea (  int    x )

Same thing, but from an x coordinate only. 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.

virtual bool KListView::isExecuteArea (  const QPoint &    point )  [virtual]

This function determines whether the given coordinates are within the execute area. The execute area is the part of a QListViewItem where mouse clicks or double clicks respectively generate a executed() signal. Depending on QListView::allColumnsShowFocus() this is either the whole item or only the first column. Returns: true if point is inside execute area of an item, false in all other cases including the case that it is over the viewport.

bool KListView::isRenameable (  int    column )  const

Returns: true if column is renamable.

QListViewItem* KListView::itemAtIndex (  int    index )

Returns the item of index within the item tree or 0 if index doesn't exist in this list view. This function takes all items into account not only the visible ones.

int KListView::itemIndex (  const QListViewItem *    item )  const

Returns the index of item within the item tree or -1 if item doesn't exist in this list view. This function takes all items into account not only the visible ones.

void KListView::itemRenamed (  QListViewItem *    item )  [signal]

Same as above, but without the extra information.

void KListView::itemRenamed (  QListViewItem *    item, const QString &    str, int    col )  [signal]

This signal gets emitted when an item is renamed via in-place renaming. Parameters: item  is the renamed item. str  is the new value of column col. col  is the renamed column.

bool KListView::itemsMovable (    )

Returns: if it is legal to move items in the list view

bool KListView::itemsRenameable (    )

Returns: whether inplace-renaming has been enabled. See also: setItemsRenameable()

virtual void KListView::keyPressEvent (  QKeyEvent *    )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected. Reimplemented in KFileDetailView.

QListViewItem* KListView::lastChild (    )

Returns: the last child of this listview.

QListViewItem* KListView::lastItem (    )

Returns: the last item (not child!) of this listview. See also: lastChild()

virtual void KListView::leaveEvent (  QEvent *    e )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

void KListView::menuShortCutPressed (  KListView *    list, QListViewItem *    item )  [signal]

This signal is emitted when the shortcut key for popup-menus is pressed. Normally you should not use this, just connect a slot to signal contextMenu (KListView*, QListViewItem*, const QPoint&) to correctly handle showing context menus regardless of settings. Parameters: list  is this listview. item  is the currentItem() at the time the key was pressed. May be 0L.

virtual void KListView::movableDropEvent (  QListViewItem *    parent, QListViewItem *    afterme )  [protected, virtual]

Handle dropEvent when itemsMovable() is set to true.

void KListView::moved (  QPtrList< QListViewItem > &    items, QPtrList< QListViewItem > &    afterFirst, QPtrList< QListViewItem > &    afterNow )  [signal]

This signal is emitted after all the items have been moved. It reports info for each and every item moved, in order. The first element in items associates with the first of afterFirst and afterNow.

void KListView::moved (  QListViewItem *    item, QListViewItem *    afterFirst, QListViewItem *    afterNow )  [signal]

This signal is emitted when ever the user moves an item in the list via DnD. If more than one item is moved at the same time, afterFirst and afterNow will reflect what was true before the move. This differs from moved(), so be careful. All the items will have been moved before moved() is emitted, which is not true in this method. // FIXME Parameters: item  the item that was moved afterFirst  the item that parameter item was in before the move, in the list afterNow  the item it's currently after.

void KListView::moved (    )  [signal]

This signal is emitted when ever the user moves an item in the list via DnD. If more than one item is moved at the same time, this signal is only emitted once.

void KListView::moveItem (  QListViewItem *    item, QListViewItem *    parent, QListViewItem *    after )

Arbitrarily move item to parent, positioned immediately after item after.

virtual void KListView::removeColumn (  int    index )  [virtual]

Reimplemented for full width support

virtual void KListView::rename (  QListViewItem *    item, int    c )  [virtual, slot]

Rename column c of item.

KLineEdit* KListView::renameLineEdit (    )

Returns: the lineedit used for inline renaming. Use that to setup a KCompletion or QValidator for the lineedit

void KListView::restoreLayout (  KConfig *    config, const QString &    group )

Reads the list view's layout from a KConfig group as stored with saveLayout Parameters: config  the KConfig object to read from group  the config group to use

void KListView::saveLayout (  KConfig *    config, const QString &    group )  const

Saves the list view's layout (column widtsh, column order, sort column) to a KConfig group Parameters: config  the KConfig object to write to group  the config group to use

QPtrList<QListViewItem> KListView::selectedItems (    )

Returns: a list containing the currently selected items.

SelectionModeExt KListView::selectionModeExt (    )

Returns: the "extended" selection mode of this listview. See also: SelectionModeExt , setSelectionModeExt

virtual void KListView::setAcceptDrops (  bool    )  [virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

void KListView::setAlternateBackground (  const QColor &    c )

sets the alternate background background color. This only has an effect if the items are KListViewItems Parameters: c  the color to use for every other item. Set to an invalid colour to disable alternate colours.

virtual void KListView::setAutoOpen (  bool    b )  [virtual, slot]

Enable/Disable AutoOpen (not implemented currently).

virtual void KListView::setCreateChildren (  bool    b )  [virtual, slot]

For future expansions. Do not use. Deprecated:

virtual void KListView::setDragEnabled (  bool    b )  [virtual, slot]

Enable/Disable the dragging of items. It is disabled by default.

virtual void KListView::setDropHighlighter (  bool    b )  [virtual, slot]

Enable/Disable the drawing of a drop-highlighter (a rectangle around the item under the mouse cursor). It is disabled by default.

virtual void KListView::setDropVisualizer (  bool    b )  [virtual, slot]

Enable/Disable the drawing of a drop-visualizer (a bar that shows where a dropped item would be inserted). It is enabled by default, if dragging is enabled

void KListView::setDropVisualizerWidth (  int    w )  [slot]

Set the width of the (default) drop-visualizer. If you don't call this method, the width is set to 4.

void KListView::setFullWidth (  bool    fullWidth )

Let the last column fit exactly all the available width.

void KListView::setFullWidth (    )

Deprecated:

virtual void KListView::setItemsMovable (  bool    b )  [virtual, slot]

Set whether items in the list view can be moved. It is enabled by default. See also: itemsMovable()

virtual void KListView::setItemsRenameable (  bool    b )  [virtual, slot]

Enables inplace-renaming of items. It is disabled by default. See also: itemsRenameable() , setRenameable()

void KListView::setRenameable (  int    column, bool    yesno = true )  [slot]

By default, if you called setItemsRenameable(true), only the first column is renameable. Use this function to enable the feature on other columns. If you want more intelligent (dynamic) selection, you'll have to derive from KListView, and override rename() and call only call it if you want the item to be renamed.

void KListView::setSelectionModeExt (  SelectionModeExt    mode )  [slot]

Set the selection mode. A different name was chosen to avoid API-clashes with QListView::setSelectionMode().

virtual void KListView::setSorting (  int    column, bool    ascending = true )  [virtual]

Reimplemented to remember the current sort column and order

void KListView::setTabOrderedRenaming (  bool    b )  [slot]

Enable/disable tabbing between editable cells Since: 3.1

virtual void KListView::setTooltipColumn (  int    column )  [virtual, slot]

Set which column should be used for automatic tooltips. Parameters: column  is the column for which tooltips will be shown. Set -1 to disable this feature.

virtual bool KListView::showTooltip (  QListViewItem *    item, const QPoint &    pos, int    column )  const [protected, virtual]

Returns: whether the tooltip for column of item shall be shown at point pos.

void KListView::slotAutoSelect (    )  [protected, slot]

Process AutoSelection.

void KListView::slotHeaderChanged (    )  [protected, slot]

Reacts to header changes in full width mode

void KListView::slotOnItem (  QListViewItem *    item )  [protected, slot]

Accessory slot for AutoSelect

void KListView::slotOnViewport (    )  [protected, slot]

Accessory slot for AutoSelect/ChangeCursorOverItem

void KListView::slotSettingsChanged (  int    )  [protected, slot]

Update internal settings whenever the global ones change.

virtual void KListView::startDrag (    )  [protected, virtual]

This method calls dragObject() and starts the drag. Reimplement it to do fancy stuff like setting a pixmap or using a non-default DragMode

bool KListView::tabOrderedRenaming (    )  [slot]

Returns whether tab ordered renaming is enabled Since: 3.1

virtual QString KListView::tooltip (  QListViewItem *    item, int    column )  const [protected, virtual]

Returns: the tooltip for column of item.

int KListView::tooltipColumn (    )

Returns: the column for which tooltips are displayed (or -1 if none set).

virtual void KListView::viewportPaintEvent (  QPaintEvent *    )  [protected, virtual]

Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

virtual void KListView::viewportResizeEvent (  QResizeEvent *    e )  [protected, virtual]

Reimplemented for setFullWidth()

---

The documentation for this class was generated from the following file:

• klistview.h

---