org.kde.koala
Interface KListViewSignals


public interface KListViewSignals


Method Summary
 void aboutToMove()
          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.
 void contextMenu(KListView l, org.kde.qt.QListViewItem i, org.kde.qt.QPoint p)
          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).
 void dropped(KListView list, org.kde.qt.QDropEvent e, org.kde.qt.QListViewItem after)
          This signal gets emitted whenever something acceptable is dropped onto the listview.
 void dropped(KListView list, org.kde.qt.QDropEvent e, org.kde.qt.QListViewItem parent, org.kde.qt.QListViewItem after)
          This signal gets emitted whenever something acceptable is dropped onto the listview.
 void dropped(org.kde.qt.QDropEvent e, org.kde.qt.QListViewItem after)
          This signal gets emitted whenever something acceptable is dropped onto the listview.
 void dropped(org.kde.qt.QDropEvent e, org.kde.qt.QListViewItem parent, org.kde.qt.QListViewItem after)
          This signal gets emitted whenever something acceptable is dropped onto the listview.
 void executed(org.kde.qt.QListViewItem item)
          This signal is emitted whenever the user executes an listview item.
 void executed(org.kde.qt.QListViewItem item, org.kde.qt.QPoint pos, int c)
          This signal is emitted whenever the user executes an listview item.
 void itemAdded(org.kde.qt.QListViewItem item)
           
 void itemRemoved(org.kde.qt.QListViewItem item)
           
 void itemRenamed(org.kde.qt.QListViewItem item)
          Same as above, but without the extra information.
 void itemRenamed(org.kde.qt.QListViewItem item, java.lang.String str, int col)
          This signal gets emitted when an item is renamed via in-place renaming.
 void menuShortCutPressed(KListView list, org.kde.qt.QListViewItem item)
          This signal is emitted when the shortcut key for popup-menus is pressed.
 void moved()
          This signal is emitted when ever the user moves an item in the list via DnD.
 void moved(org.kde.qt.QListViewItem item, org.kde.qt.QListViewItem afterFirst, org.kde.qt.QListViewItem afterNow)
          This signal is emitted when ever the user moves an item in the list via DnD.
 

Method Detail

executed

void executed(org.kde.qt.QListViewItem item)
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.

executed

void executed(org.kde.qt.QListViewItem item,
              org.kde.qt.QPoint pos,
              int c)
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.

dropped

void dropped(org.kde.qt.QDropEvent e,
             org.kde.qt.QListViewItem after)
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 occurred (or null, if the drop was above all items)
See Also:
#acceptDrop

dropped

void dropped(KListView list,
             org.kde.qt.QDropEvent e,
             org.kde.qt.QListViewItem after)
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 occurred (or null, if the drop was above all items

dropped

void dropped(KListView list,
             org.kde.qt.QDropEvent e,
             org.kde.qt.QListViewItem parent,
             org.kde.qt.QListViewItem after)
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 occurred (or null, if the drop was above all items

dropped

void dropped(org.kde.qt.QDropEvent e,
             org.kde.qt.QListViewItem parent,
             org.kde.qt.QListViewItem after)
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 occurred (or null, if the drop was above all items

moved

void moved()
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.


aboutToMove

void aboutToMove()
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

See Also:
#moveItem

moved

void moved(org.kde.qt.QListViewItem item,
           org.kde.qt.QListViewItem afterFirst,
           org.kde.qt.QListViewItem afterNow)
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.

itemRenamed

void itemRenamed(org.kde.qt.QListViewItem item,
                 java.lang.String str,
                 int col)
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.

itemRenamed

void itemRenamed(org.kde.qt.QListViewItem item)
Same as above, but without the extra information.


menuShortCutPressed

void menuShortCutPressed(KListView list,
                         org.kde.qt.QListViewItem item)
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, 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 null.

contextMenu

void contextMenu(KListView l,
                 org.kde.qt.QListViewItem i,
                 org.kde.qt.QPoint p)
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 null.
p - is the point at which the menu should be shown.

itemAdded

void itemAdded(org.kde.qt.QListViewItem item)

itemRemoved

void itemRemoved(org.kde.qt.QListViewItem item)