CButton::SetSplitGlyph

Associates a specified glyph with the current split button control.

BOOL SetSplitGlyph(
     TCHAR chGlyph
);

Parameters

Parameter

Description

[in] chGlyph

A character that specifies the glyph to use as the split button drop-down arrow.

Return Value

true if this method is successful; otherwise, false.

Remarks

Use this method only with controls that have the button style BS_SPLITBUTTON or BS_DEFSPLITBUTTON.

A glyph is the physical representation of a character in a particular font. The chGlyphparameter is not used as the glyph, but is instead used to select a glyph from a set of system-defined glyphs. The default drop-down arrow glyph is specified by a character '6', and resembles the Unicode character BLACK DOWN-POINTING TRIANGLE (U+25BC).

This method initializes the mask member of a BUTTON_SPLITINFO structure with the BCSIF_GLYPH flag and the himlGlyph member with the chGlyph parameter, and then sends that structure in the BCM_GETSPLITINFO message that is described in the Windows SDK.

Requirements

Header: afxwin.h

This method is supported in Windows Vista and later.

Additional requirements for this method are described in Build Requirements for Windows Vista Common Controls.

See Also

Reference

CButton Class

Hierarchy Chart

CButton::GetSplitGlyph

BCM_SETSPLITINFO

BUTTON_SPLITINFO