traitsui.tree_node module

Defines the tree node descriptor used by the tree editor and tree editor factory classes.

class traitsui.tree_node.ITreeNode

Bases: traits.has_traits.Interface

activated()

Handles an object being activated.

allows_children()

Returns whether this object can have children.

append_child(child)

Appends a child to the object’s children.

can_add(add_object)

Returns whether a given object is droppable on the node.

can_auto_close()

Returns whether the object’s children should be automatically closed.

can_auto_open()

Returns whether the object’s children should be automatically opened.

can_copy()

Returns whether the object’s children can be copied.

can_delete()

Returns whether the object’s children can be deleted.

can_delete_me()

Returns whether the object can be deleted.

can_insert()

Returns whether the object’s children can be inserted (vs. appended).

can_rename()

Returns whether the object’s children can be renamed.

can_rename_me()

Returns whether the object can be renamed.

click()

Handles an object being clicked.

confirm_delete()

Checks whether a specified object can be deleted.

The following return values are possible:

• True if the object should be deleted with no further prompting.
• False if the object should not be deleted.
• Anything else: Caller should take its default action (which might include prompting the user to confirm deletion).

dclick()

Handles an object being double-clicked.

delete_child(index)

Deletes a child at a specified index from the object’s children.

drop_object(dropped_object)

Returns a droppable version of a specified object.

get_add()

Returns the list of classes that can be added to the object.

get_children()

Gets the object’s children.

get_children_id()

Gets the object’s children identifier.

get_column_labels(object)

Get the labels for any columns that have been defined.

get_drag_object()

Returns a draggable version of a specified object.

get_icon(is_expanded)

Returns the icon for a specified object.

get_icon_path()

Returns the path used to locate an object’s icon.

get_label()

Gets the label to display for a specified object.

get_menu()

Returns the right-click context menu for an object.

get_name()

Returns the name to use when adding a new object instance (displayed in the “New” submenu).

get_tooltip()

Gets the tooltip to display for a specified object.

get_view()

Gets the view to use when editing an object.

has_children()

Returns whether the object has children.

insert_child(index, child)

Inserts a child into the object’s children.

select()

Handles an object being selected.

set_label(label)

Sets the label for a specified object.

when_children_changed(listener, remove)

Sets up or removes a listener for children being changed on a specified object.

when_children_replaced(listener, remove)

Sets up or removes a listener for children being replaced on a specified object.

when_column_labels_change(object, listener, remove)

Sets up or removes a listener for the column labels being changed on a specified object.

This will fire when either the list is reassigned or when it is modified. I.e., it listens both to the trait change event and the trait_items change event. Implement the listener appropriately to handle either case.

when_label_changed(listener, remove)

Sets up or removes a listener for the label being changed on a specified object.

class traitsui.tree_node.ITreeNodeAdapter(adaptee, **traits)

Bases: traits.adaptation.adapter.Adapter

Abstract base class for an adapter that implements the ITreeNode interface.

Usage:

1. Create a subclass of ITreeNodeAdapter.
2. Register the adapter to define what class (or classes) this is an ITreeNode adapter for (ie. register_factory(<from class>, ITreeNode, ITreeNodeAdapter)).
3. Override any of the following methods as necessary, using the self.adaptee trait to access the adapted object if needed.

Note

This base class implements all of the ITreeNode interface methods, but does not necessarily provide useful implementations for all of the methods. It allows you to get a new adapter class up and running quickly, but you should carefully review your final adapter implementation class to make sure it behaves correctly in your application.

activated()

Handles an object being activated.

allows_children()

Returns whether this object can have children.

append_child(child)

Appends a child to the object’s children.

can_add(add_object)

Returns whether a given object is droppable on the node.

can_auto_close()

Returns whether the object’s children should be automatically closed.

can_auto_open()

Returns whether the object’s children should be automatically opened.

can_copy()

Returns whether the object’s children can be copied.

can_delete()

Returns whether the object’s children can be deleted.

can_delete_me()

Returns whether the object can be deleted.

can_insert()

Returns whether the object’s children can be inserted (vs. appended).

can_rename()

Returns whether the object’s children can be renamed.

can_rename_me()

Returns whether the object can be renamed.

click()

Handles an object being clicked.

confirm_delete()

Checks whether a specified object can be deleted.

The following return values are possible:

• True if the object should be deleted with no further prompting.
• False if the object should not be deleted.
• Anything else: Caller should take its default action (which might include prompting the user to confirm deletion).

dclick()

Handles an object being double-clicked.

delete_child(index)

Deletes a child at a specified index from the object’s children.

drop_object(dropped_object)

Returns a droppable version of a specified object.

get_add()

Returns the list of classes that can be added to the object.

get_background()

Returns the background for object

get_children()

Gets the object’s children.

get_children_id()

Gets the object’s children identifier.

get_column_labels()

Get the labels for any columns that have been defined.

get_drag_object()

Returns a draggable version of a specified object.

get_foreground()

Returns the foreground for object

get_icon(is_expanded)

Returns the icon for a specified object.

get_icon_path()

Returns the path used to locate an object’s icon.

get_label()

Gets the label to display for a specified object.

get_menu()

Returns the right-click context menu for an object.

get_name()

Returns the name to use when adding a new object instance (displayed in the “New” submenu).

get_tooltip()

Gets the tooltip to display for a specified object.

get_view()

Gets the view to use when editing an object.

has_children()

Returns whether the object has children.

insert_child(index, child)

Inserts a child into the object’s children.

select()

Handles an object being selected.

set_label(label)

Sets the label for a specified object.

when_children_changed(listener, remove)

Sets up or removes a listener for children being changed on a specified object.

when_children_replaced(listener, remove)

Sets up or removes a listener for children being replaced on a specified object.

when_column_labels_change(listener, remove)

Sets up or removes a listener for the column labels being changed on a specified object.

This will fire when either the list is reassigned or when it is modified. I.e., it listens both to the trait change event and the trait_items change event. Implement the listener appropriately to handle either case.

when_label_changed(listener, remove)

Sets up or removes a listener for the label being changed on a specified object.

class traitsui.tree_node.ITreeNodeAdapterBridge

Bases: traits.has_traits.HasPrivateTraits

Private class for use by a toolkit-specific implementation of the TreeEditor to allow bridging the TreeNode interface used by the editor to the ITreeNode interface used by object adapters.

activated(object)

Handles an object being activated.

allows_children(object)

Returns whether this object can have children.

append_child(object, child)

Appends a child to the object’s children.

can_add(object, add_object)

Returns whether a given object is droppable on the node.

can_auto_close(object)

Returns whether the object’s children should be automatically closed.

can_auto_open(object)

Returns whether the object’s children should be automatically opened.

can_copy(object)

Returns whether the object’s children can be copied.

can_delete(object)

Returns whether the object’s children can be deleted.

can_delete_me(object)

Returns whether the object can be deleted.

can_insert(object)

Returns whether the object’s children can be inserted (vs. appended).

can_rename(object)

Returns whether the object’s children can be renamed.

can_rename_me(object)

Returns whether the object can be renamed.

click(object)

Handles an object being clicked.

confirm_delete(object)

Checks whether a specified object can be deleted.

The following return values are possible:

• True if the object should be deleted with no further prompting.
• False if the object should not be deleted.
• Anything else: Caller should take its default action (which might include prompting the user to confirm deletion).

dclick(object)

Handles an object being double-clicked.

delete_child(object, index)

Deletes a child at a specified index from the object’s children.

drop_object(object, dropped_object)

Returns a droppable version of a specified object.

get_add(object)

Returns the list of classes that can be added to the object.

get_background(object)

Returns the background for object

get_children(object)

Gets the object’s children.

get_children_id(object)

Gets the object’s children identifier.

get_column_labels(object)

Get the labels for any columns that have been defined.

get_drag_object(object)

Returns a draggable version of a specified object.

get_foreground(object)

Returns the foreground for object

get_icon(object, is_expanded)

Returns the icon for a specified object.

get_icon_path(object)

Returns the path used to locate an object’s icon.

get_label(object)

Gets the label to display for a specified object.

get_menu(object)

Returns the right-click context menu for an object.

get_name(object)

Returns the name to use when adding a new object instance (displayed in the “New” submenu).

get_tooltip(object)

Gets the tooltip to display for a specified object.

get_view(object)

Gets the view to use when editing an object.

has_children(object)

Returns whether the object has children.

insert_child(object, index, child)

Inserts a child into the object’s children.

select(object)

Handles an object being selected.

set_label(object, label)

Sets the label for a specified object.

when_children_changed(object, listener, remove)

Sets up or removes a listener for children being changed on a specified object.

when_children_replaced(object, listener, remove)

Sets up or removes a listener for children being replaced on a specified object.

when_column_labels_change(object, listener, remove)

Sets up or removes a listener for the column labels being changed on a specified object.

This will fire when either the list is reassigned or when it is modified. I.e., it listens both to the trait change event and the trait_items change event. Implement the listener appropriately to handle either case.

when_label_changed(object, listener, remove)

Sets up or removes a listener for the label being changed on a specified object.

class traitsui.tree_node.MultiTreeNode(**traits)

Bases: traitsui.tree_node.TreeNode

activated(object)

Handles an object being activated.

allows_children(object)

Returns whether this object can have children (True for this class).

can_add(object, add_object)

Returns whether a given object is droppable on the node (False for this class).

can_auto_close(object)

Returns whether the object’s children should be automatically closed.

can_auto_open(object)

Returns whether the object’s children should be automatically opened.

can_copy(object)

Returns whether the object’s children can be copied.

can_delete(object)

Returns whether the object’s children can be deleted (False for this class).

can_delete_me(object)

Returns whether the object can be deleted (True for this class).

can_insert(object)

Returns whether the object’s children can be inserted (False, meaning that children are appended, for this class).

can_rename(object)

Returns whether the object’s children can be renamed (False for this class).

can_rename_me(object)

Returns whether the object can be renamed (False for this class).

click(object)

Handles an object being clicked.

dclick(object)

Handles an object being double-clicked.

drop_object(object, dropped_object)

Returns a droppable version of a specified object.

get_add(object)

Returns the list of classes that can be added to the object.

get_children(object)

Gets the object’s children.

get_children_id(object)

Gets the object’s children identifier.

get_drag_object(object)

Returns a draggable version of a specified object.

get_icon(object, is_expanded)

Returns the icon for a specified object.

get_icon_path(object)

Returns the path used to locate an object’s icon.

get_label(object)

Gets the label to display for a specified object.

get_menu(object)

Returns the right-click context menu for an object.

get_name(object)

Returns the name to use when adding a new object instance (displayed in the “New” submenu).

get_view(object)

Gets the view to use when editing an object.

has_children(object)

Returns whether this object has children (True for this class).

select(object)

Handles an object being selected.

set_label(object, label)

Sets the label for a specified object.

when_children_changed(object, listener, remove)

Sets up or removes a listener for children being changed on a specified object.

when_children_replaced(object, listener, remove)

Sets up or removes a listener for children being replaced on a specified object.

when_label_changed(object, listener, remove)

Sets up or removes a listener for the label being changed on a specified object.

class traitsui.tree_node.ObjectTreeNode(**traits)

Bases: traitsui.tree_node.TreeNode

activated(object)

Handles an object being activated.

allows_children(object)

Returns whether this object can have children.

append_child(object, child)

Appends a child to the object’s children.

can_add(object, add_object)

Returns whether a given object is droppable on the node.

can_auto_close(object)

Returns whether the object’s children should be automatically closed.

can_auto_open(object)

Returns whether the object’s children should be automatically opened.

can_copy(object)

Returns whether the object’s children can be copied.

can_delete(object)

Returns whether the object’s children can be deleted.

can_delete_me(object)

Returns whether the object can be deleted.

can_insert(object)

Returns whether the object’s children can be inserted (vs. appended).

can_rename(object)

Returns whether the object’s children can be renamed.

can_rename_me(object)

Returns whether the object can be renamed.

click(object)

Handles an object being clicked.

confirm_delete(object)

Checks whether a specified object can be deleted.

The following return values are possible:

• True if the object should be deleted with no further prompting.
• False if the object should not be deleted.
• Anything else: Caller should take its default action (which might include prompting the user to confirm deletion).

dclick(object)

Handles an object being double-clicked.

delete_child(object, index)

Deletes a child at a specified index from the object’s children.

drop_object(object, dropped_object)

Returns a droppable version of a specified object.

get_add(object)

Returns the list of classes that can be added to the object.

get_children(object)

Gets the object’s children.

get_children_id(object)

Gets the object’s children identifier.

get_drag_object(object)

Returns a draggable version of a specified object.

get_icon(object, is_expanded)

Returns the icon for a specified object.

get_icon_path(object)

Returns the path used to locate an object’s icon.

get_label(object)

Gets the label to display for a specified object.

get_menu(object)

Returns the right-click context menu for an object.

get_name(object)

Returns the name to use when adding a new object instance (displayed in the “New” submenu).

get_tooltip(object)

Gets the tooltip to display for a specified object.

get_view(object)

Gets the view to use when editing an object.

has_children(object)

Returns whether the object has children.

insert_child(object, index, child)

Inserts a child into the object’s children.

is_node_for(object)

Returns whether this is the node that should handle a specified object.

select(object)

Handles an object being selected.

set_label(object, label)

Sets the label for a specified object.

when_children_changed(object, listener, remove)

Sets up or removes a listener for children being changed on a specified object.

when_children_replaced(object, listener, remove)

Sets up or removes a listener for children being replaced on a specified object.

when_label_changed(object, listener, remove)

Sets up or removes a listener for the label being changed on a specified object.

class traitsui.tree_node.TreeNode(**traits)

Bases: traits.has_traits.HasPrivateTraits

Represents a tree node. Used by the tree editor and tree editor factory classes.

activated(object)

Handles an object being activated.

allows_children(object)

Returns whether this object can have children.

append_child(object, child)

Appends a child to the object’s children.

can_add(object, add_object)

Returns whether a given object is droppable on the node.

can_auto_close(object)

Returns whether the object’s children should be automatically closed.

can_auto_open(object)

Returns whether the object’s children should be automatically opened.

can_copy(object)

Returns whether the object’s children can be copied.

can_delete(object)

Returns whether the object’s children can be deleted.

can_delete_me(object)

Returns whether the object can be deleted.

can_insert(object)

Returns whether the object’s children can be inserted (vs. appended).

can_rename(object)

Returns whether the object’s children can be renamed.

can_rename_me(object)

Returns whether the object can be renamed.

click(object)

Handles an object being clicked.

confirm_delete(object)

Checks whether a specified object can be deleted.

The following return values are possible:

• True if the object should be deleted with no further prompting.
• False if the object should not be deleted.
• Anything else: Caller should take its default action (which might include prompting the user to confirm deletion).

dclick(object)

Handles an object being double-clicked.

delete_child(object, index)

Deletes a child at a specified index from the object’s children.

drop_object(object, dropped_object)

Returns a droppable version of a specified object.

get_add(object)

Returns the list of classes that can be added to the object.

get_background(object)

get_children(object)

Gets the object’s children.

get_children_id(object)

Gets the object’s children identifier.

get_column_labels(object)

Get the labels for any columns that have been defined.

get_drag_object(object)

Returns a draggable version of a specified object.

get_foreground(object)

get_icon(object, is_expanded)

Returns the icon for a specified object.

get_icon_path(object)

Returns the path used to locate an object’s icon.

get_label(object)

Gets the label to display for a specified object.

get_menu(object)

Returns the right-click context menu for an object.

get_name(object)

Returns the name to use when adding a new object instance (displayed in the “New” submenu).

get_tooltip(object)

Gets the tooltip to display for a specified object.

get_view(object)

Gets the view to use when editing an object.

has_children(object)

Returns whether the object has children.

insert_child(object, index, child)

Inserts a child into the object’s children.

is_addable(klass)

Returns whether a specified object class can be added to the node.

is_node_for(object)

Returns whether this is the node that handles a specified object.

select(object)

Handles an object being selected.

set_label(object, label)

Sets the label for a specified object.

when_children_changed(object, listener, remove)

Sets up or removes a listener for children being changed on a specified object.

when_children_replaced(object, listener, remove)

Sets up or removes a listener for children being replaced on a specified object.

when_column_labels_change(object, listener, remove)

Sets up or removes a listener for the column labels being changed on a specified object.

This will fire when either the list is reassigned or when it is modified. I.e., it listens both to the trait change event and the trait_items change event. Implement the listener appropriately to handle either case.

when_label_changed(object, listener, remove)

Sets up or removes a listener for the label being changed on a specified object.

class traitsui.tree_node.TreeNodeObject

Bases: traits.has_traits.HasPrivateTraits

Represents the object that corresponds to a tree node.

tno_activated(node)

Handles an object being activated.

tno_allows_children(node)

Returns whether this object allows children.

tno_append_child(node, child)

Appends a child to the object’s children.

tno_can_add(node, add_object)

Returns whether a given object is droppable on the node.

tno_can_auto_close(node)

Returns whether the object’s children should be automatically closed.

tno_can_auto_open(node)

Returns whether the object’s children should be automatically opened.

tno_can_copy(node)

Returns whether the object’s children can be copied.

tno_can_delete(node)

Returns whether the object’s children can be deleted.

tno_can_delete_me(node)

Returns whether the object can be deleted.

tno_can_insert(node)

Returns whether the object’s children can be inserted (vs. appended).

tno_can_rename(node)

Returns whether the object’s children can be renamed.

tno_can_rename_me(node)

Returns whether the object can be renamed.

tno_click(node)

Handles an object being clicked.

tno_confirm_delete(node)

Checks whether a specified object can be deleted.

The following return values are possible:

• True if the object should be deleted with no further prompting.
• False if the object should not be deleted.
• Anything else: Caller should take its default action (which might include prompting the user to confirm deletion).

tno_dclick(node)

Handles an object being double-clicked.

tno_delete_child(node, index)

Deletes a child at a specified index from the object’s children.

tno_drop_object(node, dropped_object)

Returns a droppable version of a specified object.

tno_get_add(node)

Returns the list of classes that can be added to the object.

tno_get_children(node)

Gets the object’s children.

tno_get_children_id(node)

Gets the object’s children identifier.

tno_get_drag_object(node)

Returns a draggable version of a specified object.

tno_get_icon(node, is_expanded)

Returns the icon for a specified object.

tno_get_icon_path(node)

Returns the path used to locate an object’s icon.

tno_get_label(node)

Gets the label to display for a specified object.

tno_get_menu(node)

Returns the right-click context menu for an object.

tno_get_name(node)

Returns the name to use when adding a new object instance (displayed in the “New” submenu).

tno_get_tooltip(node)

Gets the tooltip to display for a specified object.

tno_get_view(node)

Gets the view to use when editing an object.

tno_has_children(node)

Returns whether this object has children.

tno_insert_child(node, index, child)

Inserts a child into the object’s children.

tno_is_node_for(node)

Returns whether this is the node that should handle a specified object.

tno_select(node)

Handles an object being selected.

tno_set_label(node, label)

Sets the label for a specified object.

tno_when_children_changed(node, listener, remove)

Sets up or removes a listener for children being changed on a specified object.

tno_when_children_replaced(node, listener, remove)

Sets up or removes a listener for children being replaced on a specified object.

tno_when_label_changed(node, listener, remove)

Sets up or removes a listener for the label being changed on a specified object.