Export (0) Print
Expand All

CButton::SetSplitStyle

Sets the style of the current split button control.

BOOL SetSplitStyle(
     UINT uSplitStyle
);

Parameter

Description

[in] uSplitStyle

A bitwise combination of split button styles. For more information, see the uSplitStyle member of the BUTTON_SPLITINFO structure.

true if this method is successful; otherwise, false.

Use this method only with controls whose button style is BS_SPLITBUTTON or BS_DEFSPLITBUTTON.

The split button styles specify the alignment, aspect ratio, and graphical format with which Windows draws a split button icon. For more information, see the uSplitStyle member of the BUTTON_SPLITINFO structure.

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

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.

The following code example defines the variable, m_splitButton, that is used to programmatically access the split button control.


public:
	// Variable to access programatically defined command link control.
	CButton m_cmdLink;
	// Variable to access programatically defined split button control.	
	CButton m_splitButton;


The following code example sets the style of the split button drop-down arrow. The BCSS_ALIGNLEFT style displays the arrow on the left side of the button, and the BCSS_STRETCH style retains the drop-down arrow's proportions when you resize the button.


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


Community Additions

ADD
Show:
© 2015 Microsoft