CButton::SetSplitStyle
Legt das Format des aktuellen Steuerelements der Auswahlschaltfläche fest.
BOOL SetSplitStyle(
UINT uSplitStyle
);
Parameter
Parameter |
Description |
|---|---|
[in] uSplitStyle |
Eine bitweise Kombination von Formaten der Auswahlschaltfläche. Weitere Informationen finden Sie im uSplitStyle-Member der BUTTON_SPLITINFO-Struktur. |
Rückgabewert
true, wenn diese Methode erfolgreich ist; andernfalls false.
Hinweise
Verwenden Sie diese Methode nur mit Steuerelementen, deren Schaltflächenformat BS_SPLITBUTTON oder BS_DEFSPLITBUTTON ist.
Die Formate der Auswahlschaltfläche geben die Ausrichtung, das Seitenverhältnis und das grafische Format an, mit dem Windows ein Symbol der Auswahlschaltfläche zeichnet. Weitere Informationen finden Sie im uSplitStyle-Member der BUTTON_SPLITINFO-Struktur.
Diese Methode initialisiert den maskBUTTON_SPLITINFO-Member einer Struktur mit dem BCSIF_STYLE-Flag und den uSplitStyle-Member mit dem uSplitStyle-Parameter und sendet dann diese Struktur in der BCM_GETSPLITINFO Meldung, die im Windows SDK beschrieben wird.
Anforderungen
Header: afxwin.h
Diese Methode wird in Windows Vista und höher unterstützt.
Zusätzliche Anforderungen für diese Methode werden in Anforderungen für die Erstellung von Windows Vista-Standardsteuerelementen beschrieben.
Beispiel
Im folgenden Codebeispiel wird die Variable, m_splitButton, die verwendet wird, um auf das SplitButton-Steuerelement programmgesteuert zuzugreifen.
public:
// Variable to access programatically defined command link control.
CButton m_cmdLink;
// Variable to access programatically defined split button control.
CButton m_splitButton;
Im folgenden Codebeispiel wird das Format des Dropdownpfeils der Auswahlschaltfläche fest. Das BCSS_ALIGNLEFT Format zeigt den Pfeil links neben der Schaltfläche, und das Format BCSS_STRETCH behält die Proportionen des Dropdownpfeils bei, wenn Sie die Größe der Schaltfläche ändern.
/*
Set the style of the split button drop-down arrow: Display the
arrow on the left and retain the arrow's proportions when resizing
the control.
*/
bRC = m_splitButton.SetSplitStyle( BCSS_ALIGNLEFT | BCSS_STRETCH );