CButton::SetDropDownState

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

更新 : 2007 年 11 月

現在の分割ボタンコントロールのドロップダウン状態を設定します。

BOOL SetDropDownState(
          BOOL fDropDown
);

パラメータ

パラメータ	説明
[入力] fDropDown	BST_DROPDOWNPUSHED 状態を設定する場合は true。それ以外の場合は false。

戻り値

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

解説

分割ボタンコントロールには、BS_SPLITBUTTON または BS_DEFSPLITBUTTON のスタイルがあり、ボタンの右にドロップダウン矢印が付いています。詳細については、「Button Styles」を参照してください。通常は、ユーザーがドロップダウン矢印をクリックしたときにドロップダウン状態が設定されます。このメソッドを使用するのは、コントロールのドロップダウン状態をプログラムによって設定する場合です。ドロップダウン矢印は、状態を示すために影付きで描画されます。

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

次のコード例では、ドロップダウン矢印がプッシュされたことを示すように分割ボタンコントロールの状態を設定しています。

 /* Set the state of the split button control to indicate that 
    the drop-down arrow is pushed. The arrow is drawn shaded to 
    indicate the state.
    */
    m_splitButton.SetDropDownState( TRUE );