CButton::SetSplitSize

2011-08-09

現在の分割ボタンコントロールのドロップダウンコンポーネントに外接する四角形を設定します。

BOOL SetSplitSize(
     LPSIZE pSize
);

パラメーター

パラメーター	説明
[入力] pSize	外接する四角形を記述する SIZE 構造体へのポインター。

戻り値

このメソッドが成功した場合は true。それ以外の場合は false。

解説

このメソッドは、ボタンスタイルが BS_SPLITBUTTON または BS_DEFSPLITBUTTON のコントロールでのみ使用します。

分割ボタンコントロールを展開すると、リストコントロールまたはページャーコントロールなどのドロップダウンコンポーネントを表示できるようになります。このメソッドでは、ドロップダウンコンポーネントを含んだ外接する四角形のサイズを指定します。

このメソッドは、BUTTON_SPLITINFO 構造体の mask メンバーを BCSIF_SIZE フラグで初期化し、size メンバーを pSize パラメーターで初期化してから、その構造体を 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;

次のコード例は、分割ボタンのドロップダウン矢印のサイズを 2 倍にします。

    // Double the size of the split button drop-down arrow.
    SIZE sz;
    bRC = m_splitButton.GetSplitSize( &sz ); // current size
    sz.cx = sz.cx * 2;
    sz.cy = sz.cy * 2;
    bRC = m_splitButton.SetSplitSize( &sz );