HeaderPane
Main
Hide
Share Link
Print

ItemExpandable Property, SftTree Object

Defines whether an item is expandable.

Deprecated - Provided for compatibility with earlier versions only - Use Item.Expandable instead

Syntax

Get

C#bool Expandable = object.get_ItemExpandable(int ItemIndex);
VB.NETExpandable = object.get_ItemExpandable(ByVal ItemIndex As Integer) As Boolean
C++VARIANT_BOOL Expandable = object->ItemExpandable[long ItemIndex];
VARIANT_BOOL Expandable = object->GetItemExpandable(long ItemIndex);
CHRESULT object->get_ItemExpandable(long ItemIndex, VARIANT_BOOL* Expandable);
VBExpandable = object.ItemExpandable(ByVal ItemIndex As Long) As Boolean

Put

C#void object.set_ItemExpandable(int ItemIndex, bool Expandable);
VB.NETobject.set_ItemExpandable(ByVal ItemIndex As Integer, ByVal Expandable As Boolean)
C++VARIANT_BOOL object->ItemExpandable[long ItemIndex] = Expandable;
void object->PutItemExpandable(long ItemIndex, VARIANT_BOOL Expandable);
CHRESULT object->put_ItemExpandable(long ItemIndex, VARIANT_BOOL Expandable);
VBobject.ItemExpandable(ByVal ItemIndex As Long) = Expandable As Boolean

object

A SftTree object.

ItemIndex

The zero-based index of the item to be made Expandable.

Expandable

Defines whether the item is Expandable.

BooleanDescription
TrueThe item is Expandable.
FalseThe item is not Expandable.

Comments

Deprecated - Provided for compatibility with earlier versions only - Use Item.Expandable instead

The ItemExpandable property defines whether an item is Expandable.

Normally, only a parent item (with dependents) is Expandable. An Expandable item displays an expand/collapse button and other attributes, such as the Items.ItemImageExpandable graphic.

A leaf item can be made a "temporary" parent item by setting the item's ItemExpandable property to True. The item now displays an expand/collapse button and other attributes, such as the Items.ItemImageExpandable graphic. The item can now also generate an ItemClick event to expand the item. The application can then add child items as the user expands this "temporary" parent item, making it into a real parent item.

When setting the ItemExpandable property, an item's dependents are always removed, unless the item is already expanded.

If an item's ItemExpandable property is set to False, the item is collapsed (and its dependents are removed).

If an item is already expanded or has dependents when setting ItemExpandable to True, the item remains unchanged. It is not expanded.

See Also SftTree Object | Object Hierarchy


Last Updated 11/03/2026 - (email)
© 2026 Softel vdm, Inc.