CSplitButton::SetDropDownMenu

ユーザーが現在の分割ボタン コントロールのドロップダウン矢印をクリックすると表示されるドロップダウン メニューを設定します。

void SetDropDownMenu(
    UINT nMenuId, 
    UINT nSubMenuId
);
void SetDropDownMenu(
    CMenu* pMenu
);

パラメーター

パラメーター	説明
[入力] nMenuId	メニュー バーのリソース id。
[入力] nSubMenuId	サブメニューのリソース id。
[入力] pMenu	サブメニューを指定する CMenu オブジェクトへのポインター。CSplitButton のオブジェクトは CSplitButton のオブジェクトがスコープ外に出ると CMenu のオブジェクトおよび対応する HMENU を削除します。

必要条件

ヘッダー: afxcmn.h

このメソッドは、Windows Vista およびそれ以降のバージョンでサポートされています。

このメソッドに関するその他の要件については、「Windows Vista コモン コントロールの作成要件」を参照してください。

解説

nMenuId のパラメーターは、メニュー バーの項目の横のリストであるメニュー バーを識別します。nSubMenuId のパラメーターは、各メニュー バーの項目に関連付けられたメニュー項目のドロップダウン リストで、サブメニューを識別する一意のインデックス番号です。たとえば、一般的なアプリケーションに、メニュー バーの項目を含むメニューが、ファイル編集「」、「」、「、および」役立ちます。「file」のメニュー バー項目にあるメニュー項目を含むサブメニューが、開いて」、「の「終了」と「終了」。分割ボタン コントロールのドロップダウン矢印をクリックすると、コントロールは指定し、そのメニュー バーを表示します。

次の図は、ページャー コントロールと (1) 分割ボタン コントロールを含むダイアログ ボックスを示しています。(2) は既にドロップダウン矢印をクリックし、(3) サブメニューが表示されます。

使用例

次のコード例の最初のステートメントは CSplitButton::SetDropDownMenu のメソッドを示します。ここでは、でメニューを自動的にメニュー バーの ID を示します Visual Studio のリソース エディター、IDR_MENU1作成しました。ゼロである nSubMenuId のパラメーターは、メニュー バーの唯一のサブメニューを示します。

    // Initialize the dropdown menu of the splitbutton control.
    m_splitButton.SetDropDownMenu(IDR_MENU1, 0);

    // Create the pager control.
    BOOL nRet;
    CRect rect;
    GetClientRect(&rect);
    nRet = m_pager.Create(
        (WS_VISIBLE | WS_CHILD | PGS_HORZ),
        CRect(rect.Width()/4, 5, (rect.Width() * 3)/4, 55),
        this,
        IDC_PAGER1); 

    m_pager.GetClientRect( &rect );
    nRet = m_button.Create(
        _T("This is a very, very long button. 012345678901234567890"), 
        (WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
        CRect(0,0,rect.Width(),30), 
        &m_pager, IDC_BUTTON1);

    m_pager.SetChild(m_button.m_hWnd);
    m_pager.SetButtonSize( 20 );
    m_pager.SetBorder( 1 );

参照

関連項目

CSplitButton クラス

階層図