HeaderPane
Main
Hide
Share Link
Print

ShowButton0

Defines the presence of level 0 expand/collapse buttons.

C

BOOL WINAPI SftBox_GetShowButton0(HWND hwndCtl);
void WINAPI SftBox_SetShowButton0(HWND hwndCtl, BOOL fSet);

C++

BOOL CSftBox::GetShowButton0() const;
void CSftBox::SetShowButton0(BOOL fSet);

Parameters

hwndCtl

The window handle of the combo box control.

fSet

Set to TRUE to display expand/collapse buttons for items on level 0, otherwise set to FALSE.

Returns

GetShowButton0 returns a value indicating whether expand/collapse buttons for items on level 0 are shown. TRUE is returned if level 0 expand/collapse buttons are shown, otherwise FALSE is returned.

Comments

The GetShowButton0 and SetShowButton0 functions define the presence of level 0 expand/collapse buttons.

The setting applies to the dropdown portion and the static portion of the combo box. When a combo box control is created, level 0 expand/collapse buttons are not shown.

If the dropdown portion of a dropdown or dropdown list combo box is currently displayed, SetShowButton0 hides it.

SetShowButtons can be used to enable or disable expand/collapse buttons on levels other than level 0. The appearance of the expand/collapse buttons can be defined using SetButtons.

Examples

C View entire sample code

    Sft_InitPicture(&aThreeItemPictures[2]);
    Sft_SetPictureIcon(&aThreeItemPictures[0], m_ahIcons[ICON_FOLDER]);    /* Expandable picture */
    Sft_SetPictureIcon(&aThreeItemPictures[1], m_ahIcons[ICON_FOLDEROPEN]);/* Expanded picture */
    Sft_SetPictureIcon(&aThreeItemPictures[2], m_ahIcons[ICON_DOCUMENT]);  /* Leaf picture */
    SftBox_SetPictures(hwndBox, aThreeItemPictures);

    SftBox_SetTreeLineStyle(hwndBox, SFTBOX_TREELINE_AUTOMATIC);// Dotted or invisible tree lines, following the Windows theme
    SftBox_SetShowButtons(hwndBox, TRUE);       // Expand/collapse buttons (level 1..n)
    SftBox_SetShowButton0(hwndBox, TRUE);       // Expand/collapse buttons (level 0)
    SftBox_SetButtons(hwndBox, SFTBOX_BUTTON_AUTOMATIC);// Button style follows the Windows theme
    SftBox_SetDroppedHeight(hwndBox, 12);       // Show up to 12 items
    SftBox_SetDarkMode(hwndBox, SFTBOX_DARKMODE_AUTO);

    // The level of an item defines the hierarchy: an item is a
    // dependent of the closest preceding item with a lower level.
    for (i = 0 ; i < FOLDER_COUNT ; ++i) {

C++ View entire sample code

    Sft_InitPicture(&aThreeItemPictures[2]);
    Sft_SetPictureIcon(&aThreeItemPictures[0], m_ahIcons[ICON_FOLDER]);    /* Expandable picture */
    Sft_SetPictureIcon(&aThreeItemPictures[1], m_ahIcons[ICON_FOLDEROPEN]);/* Expanded picture */
    Sft_SetPictureIcon(&aThreeItemPictures[2], m_ahIcons[ICON_DOCUMENT]);  /* Leaf picture */
    m_Folders.SetPictures(aThreeItemPictures);

    m_Folders.SetTreeLineStyle(SFTBOX_TREELINE_AUTOMATIC);// Dotted or invisible tree lines, following the Windows theme
    m_Folders.SetShowButtons(TRUE);     // Expand/collapse buttons (level 1..n)
    m_Folders.SetShowButton0(TRUE);     // Expand/collapse buttons (level 0)
    m_Folders.SetButtons(SFTBOX_BUTTON_AUTOMATIC);// Button style follows the Windows theme
    m_Folders.SetDroppedHeight(12);     // Show up to 12 items
    m_Folders.SetDarkMode(SFTBOX_DARKMODE_AUTO);

    // The level of an item defines the hierarchy: an item is a
    // dependent of the closest preceding item with a lower level.
    for (i = 0 ; i < count ; ++i) {

See Also C/C++ API | Categories | Notifications


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