CButton::SetSplitStyle
更新 : 2007 年 11 月
現在の分割ボタン コントロールのスタイルを設定します。
BOOL SetSplitStyle(
UINT uSplitStyle
);
パラメータ
パラメータ |
説明 |
---|---|
[入力] uSplitStyle |
分割ボタン スタイルのビット単位の組み合わせ。詳細については、BUTTON_SPLITINFO 構造体の uSplitStyle メンバを参照してください。 |
戻り値
このメソッドが成功した場合は true。それ以外の場合は false。
解説
このメソッドは、ボタン スタイルが BS_SPLITBUTTON または BS_DEFSPLITBUTTON のコントロールでのみ使用します。
分割ボタン スタイルでは、Windows が分割ボタン アイコンを描画するための配置、縦横比、グラフィック形式を指定します。詳細については、BUTTON_SPLITINFO 構造体の uSplitStyle メンバを参照してください。
このメソッドは、BUTTON_SPLITINFO 構造体の mask メンバを BCSIF_STYLE フラグで初期化し、uSplitStyle メンバを uSplitStyle パラメータで初期化してから、その構造体を BCM_GETSPLITINFO メッセージに入れて送信します。そのメッセージについては、Windows SDK を参照してください。
必要条件
ヘッダー : 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 );