Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Legt das Dropdownmenü fest, das angezeigt wird, wenn ein Benutzer auf den Dropdownpfeil des aktuellen Steuerelements der Auswahlschaltfläche klickt.
void SetDropDownMenu(
UINT nMenuId,
UINT nSubMenuId
);
void SetDropDownMenu(
CMenu* pMenu
);
Parameter
Parameter |
Description |
|---|---|
[in] nMenuId |
Das Ressourcen-ID der Menüleiste. |
[in] nSubMenuId |
Das Ressourcen-ID eines Untermenüs. |
[in] pMenu |
Zeiger auf einen CMenu-Objekt, das ein Untermenü angibt.Das Objekt CSplitButton löscht das CMenu-Objekt und das zugeordnete HMENU, wenn das CSplitButton-Objekt den Gültigkeitsbereich verlässt. |
Anforderungen
Header: afxcmn.h
Diese Methode wird in Windows Vista und höher unterstützt.
Zusätzliche Anforderungen für diese Methode werden in Build-Anforderungen für Windows Vista-gemeinsame Regelungen beschrieben.
Hinweise
Der nMenuId-Parameter identifiziert eine Menüleiste, die jeweils eine Liste von Menüleistenelementen ist.Der nSubMenuId-Parameter ist eine nullbasierte Indexnummer, die ein Untermenü angibt, das die Dropdownliste mit den Menüelementen ist, die jedem Menüleistenelement zugeordnet werden.Beispielsweise verfügt eine typische Anwendung ein Menü, das die Menüleistenelemente enthält, Datei "," Bearbeiten", und "Hilfe". Das "Datei" Menüleistenelement hat ein Untermenü, das die Menüelemente enthält, geöffnet "," Schließen" und "exit". Wenn auf den Dropdownpfeil des Steuerelements der Auswahlschaltfläche geklickt wird, zeigt das Steuerelement das angegebene Untermenü, nicht die Menüleiste an.
Die folgende Abbildung stellt ein Dialogfeld dar, das ein Pager-Steuerelement und einen (1) SplitButton-Steuerelement enthält.Klicken Sie auf den Dropdownpfeil (2) ist bereits geklickt wurde und das Untermenü (3) wird angezeigt.
.png "Dialogfeld mit einer Trennschaltfläche und einem Pagersteuerelement.")
Beispiel
Die erste Anweisung im folgenden Codebeispiel werden die CSplitButton::SetDropDownMenu-Methode.Es erstellt das Menü mit dem Visual Studio-Ressourcen-Editor, der automatisch die Menüleiste ID mit dem Namen, IDR_MENU1.Der nSubMenuId-Parameter, der null ist, ist das einzige Untermenü der Menüleiste an.
// Initialize the dropdown menu of the splitbutton control.
m_splitButton.SetDropDownMenu(IDR_MENU1, 0);
// Create the pager control.
BOOL nRet;
CRect rect;
GetClientRect(&rect);
nRet = m_pager.Create(
(WS_VISIBLE | WS_CHILD | PGS_HORZ),
CRect(rect.Width()/4, 5, (rect.Width() * 3)/4, 55),
this,
IDC_PAGER1);
m_pager.GetClientRect( &rect );
nRet = m_button.Create(
_T("This is a very, very long button. 012345678901234567890"),
(WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
CRect(0,0,rect.Width(),30),
&m_pager, IDC_BUTTON1);
m_pager.SetChild(m_button.m_hWnd);
m_pager.SetButtonSize( 20 );
m_pager.SetBorder( 1 );