Freigeben über


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 );

Siehe auch

Referenz

CButton-Klasse

Hierarchiediagramm

CButton::GetSplitStyle

CButton::GetSplitInfo

BCM_SETSPLITINFO