TreeViewItem object

A TreeViewItem is a system structure that populates the properties for individual items in a TreeView control. A TreeViewItem has no events.

Properties

TreeViewItem property

Datatype

Description

Bold

Boolean

Specifies whether the item is bold. Values are:

TRUE -- The item is bold.

FALSE -- The item is not bold.

Children

Boolean

Specifies whether the item has children. Values are:

TRUE -- The item has children.

FALSE -- The item does not have children.

You can use this property to make the TreeView behave as though it has children, even when it does not. You can do this to get ItemPopulate and ItemExpanding events when the item does not yet have any children.

ClassDefinition

PowerObject

An object of type PowerObject containing information about the class definition of the object or control.

CutHighLighted

Boolean

Specifies whether the item is the target of a cut operation. Values are:

TRUE -- The item is the target of a cut operation.

FALSE -- The item is not the target of a cut operation.

Data

Any

Assigns any user-defined data to a TreeView item.

DropHighLighted

Boolean

Specifies whether the item is the target of a DragDrop operation. Values are:

TRUE -- The item is the target of a DragDrop operation.

FALSE -- The item is not the target of a DragDrop operation.

Expanded

Boolean

Specifies whether the item is expanded. Values are:

TRUE -- The item is expanded.

FALSE -- The item is not expanded.

ExpandedOnce

Boolean

Specifies whether the item has been expanded at least once, also meaning the item has been populated with children. Values are:

TRUE -- The item has been expanded once.

FALSE -- The item has not been expanded once.

HasFocus

Boolean

Specifies whether the item has focus. Values are:

TRUE -- The item has focus.

FALSE -- The item does not have focus.

ItemHandle

Long

Identifies the handle associated with the item.

Label

String

Identifies the string label associated with the item.

Level

Integer

Indicates the level of the item in the TreeView control.

OverlayPictureIndex

Integer

Identifies the overlay picture associated with the item. The overlay picture is displayed on top of the item's picture. If 0, no overlay is displayed.

PictureIndex

Integer

Identifies the picture displayed to the left of the item label. If 0, no picture appears and the space specified by the TreeView's PictureWidth property is blank.

SelectedPictureIndex

Integer

Identifies the picture associated with the item when it is selected. If 0, no picture is displayed when selected.

Selected

Boolean

Specifies whether the item is selected. Values are:

TRUE -- The item is selected.

FALSE -- The item is not selected.

StatePictureIndex

Integer

Identifies the state picture associated with the item. The state picture appears to the left of the regular picture. If 0, no state picture appears and no space is reserved for the picture.


Functions

TreeViewItem function

Datatype returned

Description

ClassName in PowerScript Reference

String

Returns the name assigned to the object.

GetContextService in PowerScript Reference

Integer

Creates a reference to a context-specific instance of the specified service.

GetParent in PowerScript Reference

PowerObject

Returns a reference to the name of the parent object.

TypeOf in PowerScript Reference

Object

Returns the type of the object.