Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

How to Handle Drop-down Buttons

A drop-down button can present users with a list of options. To create this style of button, specify the BTNS_DROPDOWN style (also called TBSTYLE_DROPDOWN for compatibility with previous versions of the common controls). To show a drop-down button with an arrow, you must also set the TBSTYLE_EX_DRAWDDARROWS toolbar style by sending a TB_SETEXTENDEDSTYLE message.

The following illustration shows a drop-down "Open" button with the context menu open and showing a list of files. In this example, the toolbar has the TBSTYLE_EX_DRAWDDARROWS style.

Screen shot of a dialog box with three toolbar items represented by icons; one has an expanded drop-down arrow and a three-item context menu

The following illustration shows the same toolbar, this time without the TBSTYLE_EX_DRAWDDARROWS style.

Screen shot of a previous dialog box, but the icon with the context menu has no dropdown arrow

When users click a toolbar button that uses the BTNS_DROPDOWN style, the toolbar control sends its parent window a TBN_DROPDOWN notification code.

What you need to know



  • C/C++
  • Windows User Interface Programming


Handle a Drop-down Button

The following code example demonstrates how an application can support a drop-down button in a toolbar control.

BOOL DoNotify(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam)

    #define lpnm   ((LPNMHDR)lParam)
    #define lpnmTB ((LPNMTOOLBAR)lParam)

        case TBN_DROPDOWN:
            // Get the coordinates of the button.
            RECT rc;
            SendMessage(lpnmTB->hdr.hwndFrom, TB_GETRECT, (WPARAM)lpnmTB->iItem, (LPARAM)&rc);

            // Convert to screen coordinates.            
            MapWindowPoints(lpnmTB->hdr.hwndFrom, HWND_DESKTOP, (LPPOINT)&rc, 2);                         
            // Get the menu.
            HMENU hMenuLoaded = LoadMenu(g_hinst, MAKEINTRESOURCE(IDR_POPUP)); 
            // Get the submenu for the first menu item.
            HMENU hPopupMenu = GetSubMenu(hMenuLoaded, 0);

            // Set up the pop-up menu.
            // In case the toolbar is too close to the bottom of the screen, 
            // set rcExclude equal to the button rectangle and the menu will appear above 
            // the button, and not below it.
            TPMPARAMS tpm;
            tpm.cbSize    = sizeof(TPMPARAMS);
            tpm.rcExclude = rc;
            // Show the menu and wait for input. 
            // If the user selects an item, its WM_COMMAND is sent.
                             TPM_LEFTALIGN | TPM_LEFTBUTTON | TPM_VERTICAL, 
                             rc.left, rc.bottom, g_hwndMain, &tpm);

        return (FALSE);
    return FALSE;

Related topics

Using Toolbar Controls
Windows common controls demo (CppWindowsCommonControls)



Community Additions

© 2015 Microsoft