TreeView

Description

A hierarchical list whose items can contain child items.

The?ListItem?children of this control (in the?items?array) can be of type node, which means that they can contain child items. An item with child items can expanded, so that the child items are displayed, or collapsed, so that the child items are hidden Individual items can be selected at any level of the tree.

Properties

active readonly True if this element is active.
alignment readonly The alignment style for this element. If defined, this value overrides the alignChildren setting for the parent container.
bounds readonly The boundaries of the element, in parent-relative coordinates.
children readonly An array of child elements.
enabled readonly True if this element is enabled.
graphics readonly The graphics object that can be used to customize the element’s appearance, in response to the?onDraw()?event.
helpTip readonly The help text that is displayed when the mouse hovers over the element.
indent readonly The number of pixels to indent the element during automatic layout.
itemSize readonly The width and height in pixels of each item in the list.
items readonly The array of top-level items displayed in the list.
location readonly The upper left corner of this element relative to its parent.
maximumSize readonly The maximum height and width to which the element can be resized.
minimumSize readonly The minimum height and width to which the element can be resized.
parent readonly The parent element.
preferredSize readonly The preferred size, used by layout managers to determine the best size for each element.
properties readonly An object that contains one or more creation properties of the control (properties used only when the element is created).
selection readonly The currently selected list item.
shortcutKey readonly The key sequence that invokes the?onShortcutKey()?callback for this element (in Windows only).
size readonly The current dimensions of this element.
type readonly The element type, “treeview”.
visible readonly True if this element is shown, false if it is hidden.
window readonly The window that this element belongs to.
windowBounds readonly The bounds of this element relative to the top-level parent window.

Methods

add readonly Adds an item to the top-level choices in this list.
addEventListener readonly Registers an event handler for a particular type of event occuring in this element.
dispatchEvent readonly Simulates the occurrence of an event in this target.
find readonly Retrieves an item object from the list that has a given text label.
hide readonly Hides this element.
notify readonly Sends a notification message, simulating the specified user interaction event.
remove readonly Removes a child item from the list.
removeAll readonly Removes all child items from the list.
removeEventListener readonly Unregisters an event handler for a particular type of event occuring in this element.
show readonly Shows this element.

Events

onActivate readonly An event-handler callback function, called when the element acquires the keyboard focus.
onChange readonly An event-handler callback function, called when the content of the element has been changed
onCollapse readonly An event-handler callback function, called when the user collapses (closes) an expanded node in the treeview.
onDeactivate readonly An event-handler callback function, called when the element loses the keyboard focus.
onDraw readonly An event-handler callback function, called when the window is about to be drawn.
onExpand readonly An event-handler callback function, called when the user expands (opens) a collapsed node in the treeview.
onShortcutKey readonly An event-handler callback function, called when the element’s?shortcutKey?sequence is typed in the active window.