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.

Class Hierarchy¶

Inheritance diagram for class TreeEvent:

Methods Summary¶

Properties Summary¶

Class API¶

class wx.TreeEvent(NotifyEvent)¶

Possible constructors:

TreeEvent(commandType, tree, item=TreeItemId()) -> None

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:

• commandType (wx.EventType)

• tree (wx.TreeCtrl)

• item (wx.TreeItemId)

Return type:

None

---

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:

str

---

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)

Return type:

None

Properties¶

Item¶

See GetItem

---

KeyCode¶

See GetKeyCode

---

KeyEvent¶

See GetKeyEvent

---

Label¶

See GetLabel

---

OldItem¶

See GetOldItem

---

Point¶

See GetPoint