CButton::SetSplitStyle
現在の分割ボタン コントロールのスタイルを設定します。
BOOL SetSplitStyle(
UINT uSplitStyle
);
パラメーター
パラメーター |
説明 |
|---|---|
[入力] uSplitStyle |
分割ボタンのスタイルのビットごとの組み合わせ。詳細については、BUTTON_SPLITINFO の構造体の uSplitStyle のメンバーを参照してください。 |
戻り値
このメソッドが成功した場合は true。それ以外の場合は false。
解説
ボタンのスタイルが BS_SPLITBUTTON または BS_DEFSPLITBUTTONであるコントロールにのみ、このメソッドを使用します。
分割ボタンのスタイルは、Windows が分割ボタン アイコンを描画配置、縦横比とグラフィック形式を指定します。詳細については、BUTTON_SPLITINFO の構造体の uSplitStyle のメンバーを参照してください。
次に、このメソッドは BCSIF_STYLE フラグを使用して BUTTON_SPLITINFO の構造体の mask のメンバーと uSplitStyle のパラメーターの uSplitStyle の Windows SDKで説明する BCM_GETSPLITINFO のメッセージで構成されるメンバー、および送信を初期化します。
必要条件
ヘッダー: afxwin.h
このメソッドは、Windows Vista およびそれ以降のバージョンでサポートされています。
このメソッドに関するその他の要件については、「Windows Vista コモン コントロールの作成要件」を参照してください。
使用例
次のコード例では、プログラムで分割ボタン コントロールへのアクセスに使用される変数、m_splitButtonを定義します。
public:
// Variable to access programatically defined command link control.
CButton m_cmdLink;
// Variable to access programatically defined split button control.
CButton m_splitButton;
次のコード例は、分割ボタンのドロップダウン矢印のスタイルを設定します。BCSS_ALIGNLEFT のスタイルはボタンの左側の矢印を表示し、ボタンのサイズを変更すると BCSS_STRETCH のスタイルは、ドロップダウン矢印の比率を保持します。
/*
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 );