SftBox/OCX 5.0 - Combo Box Control

SftBoxItem.Expandable Property

Defines whether the item is expandable.

Syntax

Get

Put

object

A SftBoxItem object.

Boolean

Defines whether the item is expandable.

Comments

The Expandable property defines whether the 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 Expandable 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 Expandable property, an item's dependents are always removed, unless the item is already expanded.

If an item's Expandable 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 Expandable to True, the item remains unchanged. It is not expanded.

Examples

VB.NET

        If e.part = SftBoxPortionConstants.partSftBoxDropDown Then
            AxSftBox1.DropDown.Suppress() ' Make sure we don't close the drop down
        End If
        ToggleImage(AxSftBox1.get_Item(e.itemIndex).LabelImage)
    Case SftBoxAreaConstants.areaSftBoxItem
        If e.part = SftBoxPortionConstants.partSftBoxDropDown Then
            AxSftBox1.DropDown.Suppress() ' Make sure we don't close the drop down
        End If
        If AxSftBox1.get_Item(e.itemIndex).Expandable Then
            ExpandCollapseItem(e.itemIndex, e.shift)
        Else
            ToggleImage(AxSftBox1.get_Item(e.itemIndex).Image)
        End If
    Case SftBoxAreaConstants.areaSftBoxButton, SftBoxAreaConstants.areaSftBoxCell
        If e.part = SftBoxPortionConstants.partSftBoxDropDown Then
            AxSftBox1.DropDown.Suppress() ' Make sure we don't close the drop down

View Entire Sample Code

VB6

    Case areaSftBoxCellGraphic
        If Part = partSftBoxDropDown Then SftBox1.DropDown.Suppress ' Make sure we don't close the drop down
        ToggleImage SftBox1.Cell(ItemIndex, ColNum).Image
    Case areaSftBoxLabel
        If Part = partSftBoxDropDown Then SftBox1.DropDown.Suppress ' Make sure we don't close the drop down
        ToggleImage SftBox1.Item(ItemIndex).LabelImage
    Case areaSftBoxItem
        If Part = partSftBoxDropDown Then SftBox1.DropDown.Suppress ' Make sure we don't close the drop down
        If SftBox1.Item(ItemIndex).Expandable Then
            ExpandCollapseItem ItemIndex, Shift
        Else
            ToggleImage SftBox1.Item(ItemIndex).Image
        End If
    Case areaSftBoxButton, areaSftBoxCell
        If Part = partSftBoxDropDown Then SftBox1.DropDown.Suppress ' Make sure we don't close the drop down
        ExpandCollapseItem ItemIndex, Shift

View Entire Sample Code

C#

    case SftBoxAreaConstants.areaSftBoxLabel:
        if (e.part == SftBoxPortionConstants.partSftBoxDropDown)
            axSftBox1.DropDown.Suppress(); // Make sure we don't close the drop down
        ToggleImage(axSftBox1.get_Item(e.itemIndex).LabelImage);
        break;
    case SftBoxAreaConstants.areaSftBoxItem:
        if (e.part == SftBoxPortionConstants.partSftBoxDropDown)
            axSftBox1.DropDown.Suppress(); // Make sure we don't close the drop down
        if (axSftBox1.get_Item(e.itemIndex).Expandable)
            ExpandCollapseItem(e.itemIndex, e.shift);
        else
            ToggleImage(axSftBox1.get_Item(e.itemIndex).Image);
        break;
    case SftBoxAreaConstants.areaSftBoxButton:
    case SftBoxAreaConstants.areaSftBoxCell:
        if (e.part == SftBoxPortionConstants.partSftBoxDropDown)

View Entire Sample Code

C++

    case areaSftBoxLabel:
        if (Part == partSftBoxDropDown)
            m_vBox->DropDown->Suppress(); // Make sure we don't close the drop down
        ToggleImage(m_vBox->Item[ItemIndex]->LabelImage);
        break;
    case areaSftBoxItem:
        if (Part == partSftBoxDropDown)
            m_vBox->DropDown->Suppress(); // Make sure we don't close the drop down
        if (m_vBox->Item[ItemIndex]->Expandable != VARIANT_FALSE)
            ExpandCollapseItem(ItemIndex, Shift);
        else
            ToggleImage(m_vBox->Item[ItemIndex]->Image);
        break;
    case areaSftBoxButton:
    case areaSftBoxCell:
        if (Part == partSftBoxDropDown)

View Entire Sample Code

See Also SftBoxItem Object | Object Hierarchy