AGW Logo

agw_title TreeEvent

CommandTreeEvent is a special class for all events associated with tree controls.

Note

Not all accessors make sense for all events, see the event descriptions below.

hierarchy Inheritance Diagram

Inheritance diagram for: TreeEvent

Inheritance diagram of TreeEvent


method_summary Methods Summary

__init__Default class constructor.
AllowThis is the opposite of Veto: it explicitly allows the event to be processed.
GetNotifyEventReturns the actual wx.NotifyEvent.
IsAllowedReturns True if the change is allowed (Veto hasn’t been called) or
VetoPrevents the change announced by this event from happening.

API Class API

class TreeEvent(CommandTreeEvent)[source]

CommandTreeEvent is a special class for all events associated with tree controls.

Note

Not all accessors make sense for all events, see the event descriptions below.



__init__(evtType, evtId, item=None, evtKey=None, point=None, label=None)[source]

Default class constructor. For internal use: do not call it in your code!

Parameters:
  • evtType (integer) – the event type;
  • evtId (integer) – the event identifier;
  • item – an instance of GenericTreeItem;
  • evtKey (integer) – a character ordinal;
  • point – an instance of wx.Point;
  • label (string) – a GenericTreeItem text label.


Allow()[source]

This is the opposite of Veto: it explicitly allows the event to be processed. For most events it is not necessary to call this method as the events are allowed anyhow but some are forbidden by default (this will be mentioned in the corresponding event description).



GetNotifyEvent()[source]

Returns the actual wx.NotifyEvent.

Returns:An instance of wx.NotifyEvent.


IsAllowed()[source]

Returns True if the change is allowed (Veto hasn’t been called) or False otherwise (if it was).



Veto()[source]

Prevents the change announced by this event from happening.

Note

It is in general a good idea to notify the user about the reasons for vetoing the change because otherwise the applications behaviour (which just refuses to do what the user wants) might be quite surprising.

Tree

Table Of Contents

Previous topic

TreeEditTimer

Next topic

TreeFindTimer