CButton::SetSplitInfo

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

更新 : 2007 年 11 月

現在の分割ボタンコントロールの描画方法を指定するパラメータを設定します。

BOOL SetSplitInfo(
          PBUTTON_SPLITINFO pInfo
);

パラメータ

パラメータ	説明
[入力] pInfo	現在の分割ボタンコントロールを定義する BUTTON_SPLITINFO 構造体へのポインタ。

戻り値

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

解説

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

このメソッドは、BCM_SETSPLITINFO メッセージを送信します。このメッセージについては、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;

次のコード例は、分割ボタンのドロップダウン矢印に使用されるグリフを変更します。例では、既定の下向き三角形のグリフを上向き三角形のグリフで置き換えます。表示されるグリフは、BUTTON_SPLITINFO 構造体の himlGlyph メンバで指定した文字によって決まります。下向き三角形のグリフは文字 '6' で指定され、上向き三角形のグリフは文字 '5' で指定されます。比較については、便利なメソッド CButton::SetSplitGlyph を参照してください。

    /* 
    The drop-down arrow glyph is a function of the specified character. 
    The default "down" drop-down arrow glyph is specified by a 
    character '6'. Set the "up" arrow glyph, which is a character '5'.
    See the convenience method, SetSplitGlyph(), for comparison.
    */
    BUTTON_SPLITINFO bsInfo = {0};
    bsInfo.mask = BCSIF_GLYPH;
    TCHAR chGlyph = _T('5'); // "up" arrow glyph 
    bsInfo.himlGlyph = (HIMAGELIST)chGlyph;
    bRC = m_splitButton.SetSplitInfo( &bsInfo );