CButton::SetSplitStyle

[アーティクル]
09/17/2008

更新 : 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 );