phoenix_title wx.TreeEvent

A tree event holds information about events associated with wx.TreeCtrl objects.

To process input from a tree control, use these event handler macros to direct input to member functions that take a wx.TreeEvent argument.

^^

events Events Emitted by this Class

Handlers bound for the following event types will receive a wx.TreeEvent parameter.

  • EVT_TREE_BEGIN_DRAG: Begin dragging with the left mouse button. If you want to enable left-dragging you need to intercept this event and explicitly call wx.TreeEvent.Allow , as it’s vetoed by default. Also notice that the control must have an associated image list (see SetImageList()) to drag its items under MSW.

  • EVT_TREE_BEGIN_RDRAG: Begin dragging with the right mouse button. If you want to enable right-dragging you need to intercept this event and explicitly call wx.TreeEvent.Allow , as it’s vetoed by default.

  • EVT_TREE_END_DRAG: End dragging with the left or right mouse button.

  • EVT_TREE_BEGIN_LABEL_EDIT: Begin editing a label. This can be prevented by calling Veto

  • EVT_TREE_END_LABEL_EDIT: Finish editing a label. This can be prevented by calling Veto

  • EVT_TREE_DELETE_ITEM: Delete an item.

  • EVT_TREE_GET_INFO: Request information from the application.

  • EVT_TREE_SET_INFO: Information is being supplied.

  • EVT_TREE_ITEM_ACTIVATED: The item has been activated, i.e. chosen by double clicking it with mouse or from keyboard.

  • EVT_TREE_ITEM_COLLAPSED: The item has been collapsed.

  • EVT_TREE_ITEM_COLLAPSING: The item is being collapsed. This can be prevented by calling Veto

  • EVT_TREE_ITEM_EXPANDED: The item has been expanded.

  • EVT_TREE_ITEM_EXPANDING: The item is being expanded. This can be prevented by calling Veto

  • EVT_TREE_ITEM_RIGHT_CLICK: The user has clicked the item with the right mouse button.

  • EVT_TREE_ITEM_MIDDLE_CLICK: The user has clicked the item with the middle mouse button.

  • EVT_TREE_SEL_CHANGED: Selection has changed.

  • EVT_TREE_SEL_CHANGING: Selection is changing. This can be prevented by calling Veto

  • EVT_TREE_KEY_DOWN: A key has been pressed.

  • EVT_TREE_ITEM_GETTOOLTIP: The opportunity to set the item tooltip is being given to the application (call SetToolTip). Windows only.

  • EVT_TREE_ITEM_MENU: The context menu for the selected item has been requested, either by a right click or by using the menu key.

  • EVT_TREE_STATE_IMAGE_CLICK: The state image has been clicked. ^^

See also

wx.TreeCtrl


class_hierarchy Class Hierarchy

Inheritance diagram for class TreeEvent:

method_summary Methods Summary

__init__

Constructor, used by wxWidgets itself only.

GetItem

Returns the item.

GetKeyCode

Returns the key code if the event is a key event.

GetKeyEvent

Returns the key event for EVT_TREE_KEY_DOWN events.

GetLabel

Returns the label if the event is a begin or end edit label event.

GetOldItem

Returns the old item index (valid for EVT_TREE_SEL_CHANGING and EVT_TREE_SEL_CHANGED events).

GetPoint

Returns the position of the mouse pointer if the event is a drag or menu-context event.

IsEditCancelled

Returns True if the label edit was cancelled.

SetToolTip

Set the tooltip for the item (valid for EVT_TREE_ITEM_GETTOOLTIP events).


property_summary Properties Summary

Item

See GetItem

KeyCode

See GetKeyCode

KeyEvent

See GetKeyEvent

Label

See GetLabel

OldItem

See GetOldItem

Point

See GetPoint


api Class API

class wx.TreeEvent(NotifyEvent)

Possible constructors:

TreeEvent(commandType, tree, item=TreeItemId())

A tree event holds information about events associated with TreeCtrl objects.


Methods

__init__(self, commandType, tree, item=TreeItemId())

Constructor, used by wxWidgets itself only.

Parameters:


GetItem(self)

Returns the item.

Note that the item may be invalid for wxEVT_TREE_SEL_CHANGED events when the previously selected item has been deselected and there is no new selection any longer, as it notably happens when deleting all tree control items.

Return type:

wx.TreeItemId



GetKeyCode(self)

Returns the key code if the event is a key event.

Use GetKeyEvent to get the values of the modifier keys for this event (i.e. Shift or Ctrl).

Return type:

int



GetKeyEvent(self)

Returns the key event for EVT_TREE_KEY_DOWN events.

Return type:

wx.KeyEvent



GetLabel(self)

Returns the label if the event is a begin or end edit label event.

Return type:

string



GetOldItem(self)

Returns the old item index (valid for EVT_TREE_SEL_CHANGING and EVT_TREE_SEL_CHANGED events).

Return type:

wx.TreeItemId



GetPoint(self)

Returns the position of the mouse pointer if the event is a drag or menu-context event.

In both cases the position is in client coordinates - i.e. relative to the wx.TreeCtrl window (so that you can pass it directly to e.g. wx.Window.PopupMenu ).

Return type:

wx.Point



IsEditCancelled(self)

Returns True if the label edit was cancelled.

This should be called from within an EVT_TREE_END_LABEL_EDIT handler.

Return type:

bool



SetToolTip(self, tooltip)

Set the tooltip for the item (valid for EVT_TREE_ITEM_GETTOOLTIP events).

Windows only.

Parameters:

tooltip (string) –


Properties

Item

See GetItem



KeyCode

See GetKeyCode



KeyEvent

See GetKeyEvent



Label

See GetLabel



OldItem

See GetOldItem



Point

See GetPoint