Phoenix Logo

phoenix_title wx.lib.agw.customtreectrl.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.


class_hierarchy Class Hierarchy

Inheritance diagram for class TreeEvent:

method_summary Methods Summary

__init__ Default class constructor.
Allow This is the opposite of Veto: it explicitly allows the event to be processed.
GetNotifyEvent Returns the actual NotifyEvent.
IsAllowed Returns True if the change is allowed ( Veto hasn’t been called) or
Veto Prevents the change announced by this event from happening.

api Class API



class TreeEvent(CommandTreeEvent)

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.


Methods



__init__(self, evtType, evtId, item=None, evtKey=None, point=None, label=None, **kwargs)

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(self)

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(self)

Returns the actual NotifyEvent.

Returns:An instance of NotifyEvent.


IsAllowed(self)

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



Veto(self)

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.