CButton::SetSplitInfo
Gibt Parameter an, die bestimmen, wie Windows das aktuelle SplitButton-Steuerelement zeichnet.
BOOL SetSplitInfo(
PBUTTON_SPLITINFO pInfo
);
Parameter
Parameter |
Description |
---|---|
[in] pInfo |
Zeiger auf eine BUTTON_SPLITINFO-Struktur, die das aktuelle SplitButton-Steuerelement definiert. |
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.
Diese Methode sendet die BCM_SETSPLITINFO 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 Build-Anforderungen für Windows Vista-gemeinsame Regelungen 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 Symbol, das für den Dropdownpfeil der Auswahlschaltfläche verwendet wird.Das Beispiel ersetzt ein oben-zeigendes Dreieck für das standardmäßige unten-zeigende Dreieck.Das Symbol, das angezeigt wird, hängt vom Zeichen, das Sie im himlGlyph-Member der Struktur BUTTON_SPLITINFO angeben.Das unten-zeigende Dreieck wird von einem Zeichen "6 " angegeben und das oben-zeigende Dreieck wird von einem Zeichen "5 " angegeben.Zum Vergleich finden Sie die Hilfsmethode, CButton::SetSplitGlyph.
/*
The drop-down arrow glyph is a function of the specified character.
The default "down" drop-down arrow glyph is specified by a
character '6'. Set the "up" arrow glyph, which is a character '5'.
See the convenience method, SetSplitGlyph(), for comparison.
*/
BUTTON_SPLITINFO bsInfo = {0};
bsInfo.mask = BCSIF_GLYPH;
TCHAR chGlyph = _T('5'); // "up" arrow glyph
bsInfo.himlGlyph = (HIMAGELIST)chGlyph;
bRC = m_splitButton.SetSplitInfo( &bsInfo );