DisabledItemsSelectable Property, SftTreeItems Object
Defines whether disabled items can be selected by the end-user.
Syntax
Get
| VB.NET | Boolean = object.DisabledItemsSelectable As Boolean |
| VB | Boolean = object.DisabledItemsSelectable As Boolean |
| C#.NET | bool Boolean = object.DisabledItemsSelectable; |
| VC++ | VARIANT_BOOL Boolean = object->DisabledItemsSelectable;
VARIANT_BOOL Boolean = object->GetDisabledItemsSelectable(); |
| C | HRESULT object->get_DisabledItemsSelectable(VARIANT_BOOL* Boolean); |
Put
| VB.NET | object.DisabledItemsSelectable = Boolean As Boolean |
| VB | object.DisabledItemsSelectable = Boolean As Boolean |
| C#.NET | bool object.DisabledItemsSelectable = Boolean; |
| VC++ | VARIANT_BOOL object->DisabledItemsSelectable = Boolean;
void object->PutDisabledItemsSelectable(VARIANT_BOOL Boolean); |
| C | HRESULT object->put_DisabledItemsSelectable(VARIANT_BOOL Boolean); |
object
A SftTreeItems object.
Boolean
Defines whether disabled items can be selected by the end-user.
| Boolean | Description |
|---|
| True | Enabled and disabled items are equally selectable by the end-user. |
| False | Only enabled items are selectable by the end-user. Events such as the ItemClick event and others associated with item selection no longer occur for disabled items, if the DisabledItemsSelectable property is set to False. |
Comments
The DisabledItemsSelectable property defines whether disabled items can be selected by the end-user.
The Item.Enabled property defines whether an item is enabled.
Items can always be selected by an application. DisabledItemsSelectable only controls whether the end-user can select an item. The visual appearance of a disabled selected item doesn't necessarily show the item as selected, since it is disabled, but the Item.Selected properly reflects the selection status.
Properties and methods returning the selected item(s) like (Items.SelectionCount, Items.SelectionGroups, Items.SelectionGroupStart, Items.SelectionGroupEnd) may include disabled items, even if DisabledItemsSelectable is used. The Item.Enabled property can be used to test whether an item is enabled.
See Also SftTreeItems Object | Object Hierarchy
On
Off