org.kde.koala

Class KListView

public class KListView extends QListView

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 have to derive from it. Reimplement dragObject() and (possibly) startDrag(), and setDragEnabled(true). See KListViewSignals for signals emitted by KListView

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

Field Summary
static intExtended
static intFileManager
static intMulti
static intNoSelection
static intSingle
Possible selection modes.
Constructor Summary
protected KListView(Class dummy)
KListView(QWidget parent, String name)
Constructor.
KListView(QWidget parent)
KListView()
Method Summary
protected booleanacceptDrag(QDropEvent event)
protected voidactivateAutomaticSelection()
In FileManager selection mode: explicitly activate the mode in which the current item is automatically selected.
intaddColumn(String label, int width)
Reimplemented for full width support
intaddColumn(String label)
intaddColumn(QIconSet iconset, String label, int width)
Reimplemented for full width support
intaddColumn(QIconSet iconset, String label)
QColoralternateBackground()
booleanascendingSort()
protected booleanautomaticSelection()
In FileManager selection mode: return whether it is currently in the mode where the current item is selected automatically.
booleanautoOpen()
protected booleanbelow(QRect rect, QPoint p)
Determine whether a drop on position p would count as being above or below the QRect rect.
protected booleanbelow(QListViewItem i, QPoint p)
An overloaded version of below(QRect, QPoint).
StringclassName()
protected voidcleanDropVisualizer()
Repaint the rect where I was drawing the drop line.
protected voidcleanItemHighlighter()
Repaint the rect where I was drawing the drop rectangle.
intcolumnSorted()
protected voidcontentsDragEnterEvent(QDragEnterEvent arg1)
Reimplemented for internal reasons.
protected voidcontentsDragLeaveEvent(QDragLeaveEvent event)
Reimplemented for internal reasons.
protected voidcontentsDragMoveEvent(QDragMoveEvent event)
Reimplemented for internal reasons.
protected voidcontentsDropEvent(QDropEvent arg1)
Reimplemented for internal reasons.
protected voidcontentsMouseDoubleClickEvent(QMouseEvent e)
Reimplemented for internal reasons.
protected voidcontentsMouseMoveEvent(QMouseEvent e)
Reimplemented for internal reasons.
protected voidcontentsMousePressEvent(QMouseEvent e)
Reimplemented for internal reasons.
protected voidcontentsMouseReleaseEvent(QMouseEvent arg1)
Reimplemented for internal reasons.
protected voiddeactivateAutomaticSelection()
In FileManager selection mode: explicitly deactivate the mode in which the current item is automatically selected.
protected intdepthToPixels(int depth)
Convert the depth of an item into its indentation in pixels
protected voiddisableAutoSelection()
Disable AutoSelection.
voiddispose()
Delete the wrapped C++ instance ahead of finalize()
protected voiddoneEditing(QListViewItem item, int row)
booleandragEnabled()
protected QDragObjectdragObject()
protected QRectdrawDropVisualizer(QPainter p, QListViewItem parent, QListViewItem after)
Paint the drag line.
protected QRectdrawItemHighlighter(QPainter painter, QListViewItem item)
Paint the drag rectangle.
booleandropHighlighter()
booleandropVisualizer()
intdropVisualizerWidth()
The dropVisualizerWidth defaults to 4.
protected voidemitContextMenu(QListViewItem arg1, QPoint arg2, int arg3)
Emit the contextMenu signal.
protected voidemitContextMenu(KListView arg1, QListViewItem arg2)
Emit the contextMenu signal.
protected voidemitExecute(QListViewItem item, QPoint pos, int c)
Emit signal executed.
booleanevent(QEvent arg1)
Reimplemented to reload the alternate background in palette changes.
protected voidfileManagerKeyPressEvent(QKeyEvent arg1)
A special keyPressEvent (for FileManager selection mode).
protected voidfinalize()
Deletes the wrapped C++ instance
protected voidfindDrop(QPoint pos, QListViewItem parent, QListViewItem after)
Where is the nearest QListViewItem that I'm going to drop?
protected voidfocusInEvent(QFocusEvent fe)
Reimplemented for internal reasons.
protected voidfocusOutEvent(QFocusEvent fe)
Reimplemented for internal reasons.
booleanfullWidth()
Returns whether the last column is set to fit the available width.
booleanisDisposed()
Has the wrapped C++ instance been deleted?
booleanisExecuteArea(QPoint point)
This function determines whether the given coordinates are within the execute area.
booleanisExecuteArea(int x)
Same thing, but from an x coordinate only.
booleanisRenameable(int column)
QListViewItemitemAtIndex(int index)
Returns the item of index within the item tree or 0 if index doesn't exist in this list view.
intitemIndex(QListViewItem item)
Returns the index of item within the item tree or -1 if item doesn't exist in this list view.
booleanitemsMovable()
booleanitemsRenameable()
protected voidkeyPressEvent(QKeyEvent arg1)
Reimplemented for internal reasons.
QListViewItemlastChild()
QListViewItemlastItem()
protected voidleaveEvent(QEvent e)
Reimplemented for internal reasons.
QMetaObjectmetaObject()
protected voidmovableDropEvent(QListViewItem parent, QListViewItem afterme)
Handle dropEvent when itemsMovable() is set to true.
voidmoveItem(QListViewItem item, QListViewItem parent, QListViewItem after)
Arbitrarily move item to parent, positioned immediately after item after. If after is 0, item is made the first child of parent. (Un-deprecated in kde-3.4)
voidremoveColumn(int index)
Reimplemented for full width support
voidrename(QListViewItem item, int c)
Rename column c of item.
KLineEditrenameLineEdit()
protected voidresetAutoSelection()
Reset AutoSelection to the system wide setting.
voidrestoreLayout(KConfig config, String group)
Reads the list view's layout from a KConfig group as stored with saveLayout
voidsaveLayout(KConfig config, String group)
Saves the list view's layout (column widtsh, column order, sort column) to a KConfig group
intselectionModeExt()
voidsetAcceptDrops(boolean arg1)
Reimplemented for internal reasons.
voidsetAlternateBackground(QColor c)
sets the alternate background background color.
voidsetAutoOpen(boolean b)
Enable/Disable AutoOpen (not implemented currently).
voidsetDragEnabled(boolean b)
Enable/Disable the dragging of items.
voidsetDropHighlighter(boolean b)
Enable/Disable the drawing of a drop-highlighter (a rectangle around the item under the mouse cursor).
voidsetDropVisualizer(boolean b)
Enable/Disable the drawing of a drop-visualizer (a bar that shows where a dropped item would be inserted).
voidsetDropVisualizerWidth(int w)
Set the width of the (default) drop-visualizer.
voidsetFullWidth(boolean fullWidth)
Let the last column fit exactly all the available width.
voidsetItemsMovable(boolean b)
Set whether items in the list view can be moved.
voidsetItemsRenameable(boolean b)
Enables inplace-renaming of items.
voidsetRenameable(int column, boolean yesno)
By default, if you called setItemsRenameable(true), only the first column is renameable.
voidsetRenameable(int column)
voidsetSelectionModeExt(int mode)
Set the selection mode.
voidsetShadeSortColumn(boolean shadeSortColumn)
Set to true if the currently sorted column should be drawn shaded.
voidsetSorting(int column, boolean ascending)
Reimplemented to remember the current sort column and order.
voidsetSorting(int column)
voidsetTabOrderedRenaming(boolean b)
Enable/disable tabbing between editable cells
voidsetTooltipColumn(int column)
Set which column should be used for automatic tooltips.
booleanshadeSortColumn()
See if the sort column should be drawn shaded
protected booleanshowTooltip(QListViewItem item, QPoint pos, int column)
protected voidslotAutoSelect()
Process AutoSelection.
protected voidslotDragExpand()
protected voidslotHeaderChanged()
Reacts to header changes in full width mode
protected voidslotMouseButtonClicked(int btn, QListViewItem item, QPoint pos, int c)
protected voidslotOnItem(QListViewItem item)
Accessory slot for AutoSelect
protected voidslotOnViewport()
Accessory slot for AutoSelect/ChangeCursorOverItem
protected voidslotSettingsChanged(int arg1)
Update internal settings whenever the global ones change.
protected voidstartDrag()
This method calls dragObject() and starts the drag.
booleantabOrderedRenaming()
Returns whether tab ordered renaming is enabled
voidtakeItem(QListViewItem i)
Reimplemented for internal reasons.
protected Stringtooltip(QListViewItem item, int column)
inttooltipColumn()
protected voidviewportPaintEvent(QPaintEvent arg1)
Reimplemented for internal reasons.
protected voidviewportResizeEvent(QResizeEvent e)
Reimplemented for setFullWidth()

Field Detail

Extended

public static final int Extended

FileManager

public static final int FileManager

Multi

public static final int Multi

NoSelection

public static final int NoSelection

Single

public static final int Single
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 explicitly. This way e.g. SHIFT+up/PgUp then SHIFT+down/PgDn leaves no item selected

    UNKNOWN: Possible selection modes.

    Constructor Detail

    KListView

    protected KListView(Class dummy)

    KListView

    public KListView(QWidget parent, String name)
    Constructor. The parameters parent and name are handled by QListView, as usual.

    UNKNOWN: Constructor.

    KListView

    public KListView(QWidget parent)

    KListView

    public KListView()

    Method Detail

    acceptDrag

    protected boolean acceptDrag(QDropEvent event)

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

    UNKNOWN:

    activateAutomaticSelection

    protected void activateAutomaticSelection()
    In FileManager selection mode: explicitly activate the mode in which the current item is automatically selected.

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

    addColumn

    public int addColumn(String label, int width)
    Reimplemented for full width support

    See Also: KListView

    UNKNOWN: Reimplemented for full width support

    addColumn

    public int addColumn(String label)

    addColumn

    public int addColumn(QIconSet iconset, String label, int width)
    Reimplemented for full width support

    UNKNOWN: Reimplemented for full width support

    addColumn

    public int addColumn(QIconSet iconset, String label)

    alternateBackground

    public QColor alternateBackground()

    Returns: the alternate background color

    See Also: KListView

    UNKNOWN:

    ascendingSort

    public boolean ascendingSort()

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

    UNKNOWN:

    automaticSelection

    protected boolean automaticSelection()
    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 explicitly, e.g. using the mouse.

    UNKNOWN: In FileManager selection mode: return whether it is currently in the mode where the current item is selected automatically.

    autoOpen

    public boolean autoOpen()

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

    See Also: KListView

    UNKNOWN:

    below

    protected boolean below(QRect rect, QPoint p)
    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.

    UNKNOWN: Determine whether a drop on position p would count as being above or below the QRect rect.

    below

    protected boolean below(QListViewItem i, QPoint p)
    An overloaded version of below(QRect, 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.

    UNKNOWN: An overloaded version of below(QRect, QPoint).

    className

    public String className()

    cleanDropVisualizer

    protected void cleanDropVisualizer()
    Repaint the rect where I was drawing the drop line.

    UNKNOWN: Repaint the rect where I was drawing the drop line.

    cleanItemHighlighter

    protected void cleanItemHighlighter()
    Repaint the rect where I was drawing the drop rectangle.

    UNKNOWN: Repaint the rect where I was drawing the drop rectangle.

    columnSorted

    public int columnSorted()

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

    UNKNOWN:

    contentsDragEnterEvent

    protected void contentsDragEnterEvent(QDragEnterEvent arg1)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    contentsDragLeaveEvent

    protected void contentsDragLeaveEvent(QDragLeaveEvent event)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    contentsDragMoveEvent

    protected void contentsDragMoveEvent(QDragMoveEvent event)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    contentsDropEvent

    protected void contentsDropEvent(QDropEvent arg1)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    contentsMouseDoubleClickEvent

    protected void contentsMouseDoubleClickEvent(QMouseEvent e)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    contentsMouseMoveEvent

    protected void contentsMouseMoveEvent(QMouseEvent e)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    contentsMousePressEvent

    protected void contentsMousePressEvent(QMouseEvent e)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    contentsMouseReleaseEvent

    protected void contentsMouseReleaseEvent(QMouseEvent arg1)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    deactivateAutomaticSelection

    protected void deactivateAutomaticSelection()
    In FileManager selection mode: explicitly deactivate the mode in which the current item is automatically selected.

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

    depthToPixels

    protected int depthToPixels(int depth)
    Convert the depth of an item into its indentation in pixels

    UNKNOWN: Convert the depth of an item into its indentation in pixels

    disableAutoSelection

    protected void disableAutoSelection()
    Disable AutoSelection. 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.

    See Also: KListView

    UNKNOWN: Disable AutoSelection.

    dispose

    public void dispose()
    Delete the wrapped C++ instance ahead of finalize()

    doneEditing

    protected void doneEditing(QListViewItem item, int row)

    dragEnabled

    public boolean dragEnabled()

    Returns: whether dragging is enabled. False by default.

    See Also: KListView

    UNKNOWN:

    dragObject

    protected QDragObject dragObject()

    Returns: a dragobject encoding the current selection.

    See Also: KListView

    UNKNOWN:

    drawDropVisualizer

    protected QRect drawDropVisualizer(QPainter p, QListViewItem parent, QListViewItem after)
    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.

    UNKNOWN: Paint the drag line.

    drawItemHighlighter

    protected QRect drawItemHighlighter(QPainter painter, QListViewItem item)
    Paint the drag rectangle. If painter is null, don't try to :)

    Returns: the rectangle that you painted to.

    UNKNOWN: Paint the drag rectangle.

    dropHighlighter

    public boolean dropHighlighter()

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

    See Also: KListView

    UNKNOWN:

    dropVisualizer

    public boolean dropVisualizer()

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

    See Also: KListView

    UNKNOWN:

    dropVisualizerWidth

    public int dropVisualizerWidth()
    The dropVisualizerWidth defaults to 4.

    Returns: the current width of the drop-visualizer.

    See Also: KListView

    UNKNOWN: The dropVisualizerWidth defaults to 4.

    emitContextMenu

    protected void emitContextMenu(QListViewItem arg1, QPoint arg2, int arg3)
    Emit the contextMenu signal. This slot is for mouse actions.

    UNKNOWN: Emit the contextMenu signal.

    emitContextMenu

    protected void emitContextMenu(KListView arg1, QListViewItem arg2)
    Emit the contextMenu signal. This slot is for key presses.

    UNKNOWN: Emit the contextMenu signal.

    emitExecute

    protected void emitExecute(QListViewItem item, QPoint pos, int c)
    Emit signal executed.

    UNKNOWN: Emit signal executed.

    event

    public boolean event(QEvent arg1)
    Reimplemented to reload the alternate background in palette changes.

    UNKNOWN: Reimplemented to reload the alternate background in palette changes.

    fileManagerKeyPressEvent

    protected void fileManagerKeyPressEvent(QKeyEvent arg1)
    A special keyPressEvent (for FileManager selection mode).

    UNKNOWN: A special keyPressEvent (for FileManager selection mode).

    finalize

    protected void finalize()
    Deletes the wrapped C++ instance

    findDrop

    protected void findDrop(QPoint pos, QListViewItem parent, QListViewItem after)
    Where is the nearest QListViewItem that I'm going to drop? FIXME KDE 4.0: Make this method const so it can be called from an acceptDrag method without ugly casts

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

    focusInEvent

    protected void focusInEvent(QFocusEvent fe)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    focusOutEvent

    protected void focusOutEvent(QFocusEvent fe)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    fullWidth

    public boolean fullWidth()
    Returns whether the last column is set to fit the available width.

    See Also: KListView

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

    isDisposed

    public boolean isDisposed()
    Has the wrapped C++ instance been deleted?

    isExecuteArea

    public boolean isExecuteArea(QPoint point)
    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.

    UNKNOWN: This function determines whether the given coordinates are within the execute area.

    isExecuteArea

    public boolean 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.

    UNKNOWN: Same thing, but from an x coordinate only.

    isRenameable

    public boolean isRenameable(int column)

    Returns: true if column is renamable.

    See Also: KListView

    UNKNOWN:

    itemAtIndex

    public QListViewItem 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.

    UNKNOWN: Returns the item of index within the item tree or 0 if index doesn't exist in this list view.

    itemIndex

    public int itemIndex(QListViewItem item)
    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.

    UNKNOWN: Returns the index of item within the item tree or -1 if item doesn't exist in this list view.

    itemsMovable

    public boolean itemsMovable()

    Returns: if it is legal to move items in the list view. True by default.

    See Also: KListView KListView

    UNKNOWN:

    itemsRenameable

    public boolean itemsRenameable()

    Returns: whether inplace-renaming has been enabled. False by default.

    See Also: KListView

    UNKNOWN:

    keyPressEvent

    protected void keyPressEvent(QKeyEvent arg1)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    lastChild

    public QListViewItem lastChild()

    Returns: the last child of this listview.

    See Also: KListView

    UNKNOWN:

    lastItem

    public QListViewItem lastItem()

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

    See Also: KListView

    UNKNOWN:

    leaveEvent

    protected void leaveEvent(QEvent e)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    metaObject

    public QMetaObject metaObject()

    movableDropEvent

    protected void movableDropEvent(QListViewItem parent, QListViewItem afterme)
    Handle dropEvent when itemsMovable() is set to true.

    UNKNOWN: Handle dropEvent when itemsMovable() is set to true.

    moveItem

    public void moveItem(QListViewItem item, QListViewItem parent, QListViewItem after)
    Arbitrarily move item to parent, positioned immediately after item after. If after is 0, item is made the first child of parent. (Un-deprecated in kde-3.4)

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

    removeColumn

    public void removeColumn(int index)
    Reimplemented for full width support

    See Also: KListView

    UNKNOWN: Reimplemented for full width support

    rename

    public void rename(QListViewItem item, int c)
    Rename column c of item.

    UNKNOWN: Rename column c of item.

    renameLineEdit

    public KLineEdit renameLineEdit()

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

    UNKNOWN:

    resetAutoSelection

    protected void resetAutoSelection()
    Reset AutoSelection to the system wide setting.

    See Also: KListView

    UNKNOWN: Reset AutoSelection to the system wide setting.

    restoreLayout

    public void restoreLayout(KConfig config, String 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

    UNKNOWN: Reads the list view's layout from a KConfig group as stored with saveLayout

    saveLayout

    public void saveLayout(KConfig config, String group)
    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

    UNKNOWN: Saves the list view's layout (column widtsh, column order, sort column) to a KConfig group

    selectionModeExt

    public int selectionModeExt()

    Returns: the "extended" selection mode of this listview.

    See Also: SelectionModeExt KListView

    UNKNOWN:

    setAcceptDrops

    public void setAcceptDrops(boolean arg1)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    setAlternateBackground

    public void setAlternateBackground(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 color to disable alternate colors.

    See Also: KListView

    UNKNOWN: sets the alternate background background color.

    setAutoOpen

    public void setAutoOpen(boolean b)
    Enable/Disable AutoOpen (not implemented currently).

    UNKNOWN: Enable/Disable AutoOpen (not implemented currently).

    setDragEnabled

    public void setDragEnabled(boolean b)
    Enable/Disable the dragging of items. It is disabled by default.

    UNKNOWN: Enable/Disable the dragging of items.

    setDropHighlighter

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

    UNKNOWN: Enable/Disable the drawing of a drop-highlighter (a rectangle around the item under the mouse cursor).

    setDropVisualizer

    public void setDropVisualizer(boolean b)
    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

    UNKNOWN: Enable/Disable the drawing of a drop-visualizer (a bar that shows where a dropped item would be inserted).

    setDropVisualizerWidth

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

    UNKNOWN: Set the width of the (default) drop-visualizer.

    setFullWidth

    public void setFullWidth(boolean fullWidth)
    Let the last column fit exactly all the available width.

    See Also: KListView

    UNKNOWN: Let the last column fit exactly all the available width.

    setItemsMovable

    public void setItemsMovable(boolean b)
    Set whether items in the list view can be moved. It is enabled by default.

    See Also: KListView

    UNKNOWN: Set whether items in the list view can be moved.

    setItemsRenameable

    public void setItemsRenameable(boolean b)
    Enables inplace-renaming of items. It is disabled by default.

    See Also: KListView KListView

    UNKNOWN: Enables inplace-renaming of items.

    setRenameable

    public void setRenameable(int column, boolean yesno)
    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.

    UNKNOWN: By default, if you called setItemsRenameable(true), only the first column is renameable.

    setRenameable

    public void setRenameable(int column)

    setSelectionModeExt

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

    UNKNOWN: Set the selection mode.

    setShadeSortColumn

    public void setShadeSortColumn(boolean shadeSortColumn)
    Set to true if the currently sorted column should be drawn shaded. Defaults to true

    Parameters: shadeSortColumn True if sort column should be shaded.

    UNKNOWN: Set to true if the currently sorted column should be drawn shaded.

    setSorting

    public void setSorting(int column, boolean ascending)
    Reimplemented to remember the current sort column and order.

    Parameters: column is the column to be sorted, or -1 to sort in order of insertion ascending whether to sort ascending (or descending)

    UNKNOWN: Reimplemented to remember the current sort column and order.

    setSorting

    public void setSorting(int column)

    setTabOrderedRenaming

    public void setTabOrderedRenaming(boolean b)
    Enable/disable tabbing between editable cells

    UNKNOWN: Enable/disable tabbing between editable cells

    setTooltipColumn

    public void setTooltipColumn(int column)
    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.

    UNKNOWN: Set which column should be used for automatic tooltips.

    shadeSortColumn

    public boolean shadeSortColumn()
    See if the sort column should be drawn shaded

    Returns: true if the sort column should be shaded

    UNKNOWN: See if the sort column should be drawn shaded

    showTooltip

    protected boolean showTooltip(QListViewItem item, QPoint pos, int column)

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

    UNKNOWN:

    slotAutoSelect

    protected void slotAutoSelect()
    Process AutoSelection.

    UNKNOWN: Process AutoSelection.

    slotDragExpand

    protected void slotDragExpand()

    slotHeaderChanged

    protected void slotHeaderChanged()
    Reacts to header changes in full width mode

    UNKNOWN: Reacts to header changes in full width mode

    slotMouseButtonClicked

    protected void slotMouseButtonClicked(int btn, QListViewItem item, QPoint pos, int c)

    slotOnItem

    protected void slotOnItem(QListViewItem item)
    Accessory slot for AutoSelect

    UNKNOWN: Accessory slot for AutoSelect

    slotOnViewport

    protected void slotOnViewport()
    Accessory slot for AutoSelect/ChangeCursorOverItem

    UNKNOWN: Accessory slot for AutoSelect/ChangeCursorOverItem

    slotSettingsChanged

    protected void slotSettingsChanged(int arg1)
    Update internal settings whenever the global ones change.

    UNKNOWN: Update internal settings whenever the global ones change.

    startDrag

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

    UNKNOWN: This method calls dragObject() and starts the drag.

    tabOrderedRenaming

    public boolean tabOrderedRenaming()
    Returns whether tab ordered renaming is enabled

    UNKNOWN: Returns whether tab ordered renaming is enabled

    takeItem

    public void takeItem(QListViewItem i)
    Reimplemented for internal reasons.

    UNKNOWN: Reimplemented for internal reasons.

    tooltip

    protected String tooltip(QListViewItem item, int column)

    Returns: the tooltip for column of item.

    UNKNOWN:

    tooltipColumn

    public int tooltipColumn()

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

    See Also: KListView

    UNKNOWN:

    viewportPaintEvent

    protected void viewportPaintEvent(QPaintEvent arg1)
    Reimplemented for internal reasons. Further reimplementations should call this function or else some features may not work correctly. The API is unaffected.

    UNKNOWN: Reimplemented for internal reasons.

    viewportResizeEvent

    protected void viewportResizeEvent(QResizeEvent e)
    Reimplemented for setFullWidth()

    UNKNOWN: Reimplemented for setFullWidth()