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.

Inheritance Diagram

Inheritance diagram for class TreeEvent

Known Superclasses

lib.agw.customtreectrl.CommandTreeEvent

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.

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 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.