CMFCToolBarMenuButton クラス
ポップアップ メニューを含むツール バー ボタンです。
class CMFCToolBarMenuButton : public CMFCToolBarButton
メンバー
パブリック コンストラクター
[名前] |
説明 |
---|---|
CMFCToolBarMenuButton オブジェクトを構築します。 |
パブリック メソッド
[名前] |
説明 |
---|---|
指定された CMFCToolBarButton オブジェクトを、このインスタンスと比較します。 (CMFCToolBarButton::CompareWith をオーバーライドします。) |
|
別のツール バー ボタンのプロパティを現在のボタンにコピーします。 (CMFCToolBarButton::CopyFrom をオーバーライドします。) |
|
Windows メニュー ハンドルからツール バー メニューを初期化します。 |
|
ツール バー メニューのコマンドで構成される Windows メニューを作成します。 Windows メニューを識別するハンドルを返します。 |
|
ツール バー メニューを表示するために、ポップアップ メニュー オブジェクト (CMFCPopupMenu クラス) を作成します。 |
|
|
|
ツール バー メニューのコマンドのリストへの、読み取り専用アクセスを提供します。 |
|
ボタン イメージに外接する四角形を取得します。 |
|
メニューがパレット モードの場合にポップアップ メニューの行数を返します。 |
|
ボタンに関連付けられたポップアップ メニュー オブジェクトへのポインターを返します。 |
|
|
|
ユーザーがボタンを選択したときに、ボタンの境界線を表示するかどうかを判定します (CMFCToolBarButton::HaveHotBorder をオーバーライドします。) |
|
|
|
|
|
ポップアップ メニューを表示するかどうかを判断します。 |
|
ユーザーが選択したメニュー項目のサブメニューを開くことができるかどうかを判断するために、フレームワークによって呼び出されます。 |
|
ボタンが排他モードかどうか、つまり、ユーザーが別のツール バーまたはボタンの上にポインターを移動しても、ポップアップ メニューが開かれたままであるかどうかを判断します。 |
|
ポップアップ メニューがパレット モードかどうかを判断します。 |
|
|
|
ポップアップ メニューにティアオフ バーがあるかどうかを判断します。 |
|
|
|
ボタンをドラッグできるかどうかを指定します。 (CMFCToolBarButton::OnBeforeDrag をオーバーライドします。) |
|
指定されたデバイス コンテキストとドッキングの状態に応じたボタンのサイズを計算するために、フレームワークによって呼び出されます (CMFCToolBarButton::OnCalculateSize をオーバーライドします。) |
|
WM_CANCELMODE メッセージを処理するために、フレームワークによって呼び出されます。 (CMFCToolBarButton::OnCancelMode をオーバーライドします。) |
|
新しいツール バーにボタンが挿入されたときに、フレームワークによって呼び出されます。 (CMFCToolBarButton::OnChangeParentWnd をオーバーライドします。) |
|
ユーザーがマウス ボタンをクリックすると、フレームワークによって呼び出されます。 (CMFCToolBarButton::OnClick をオーバーライドします。) |
|
ユーザーがポップアップ メニュー内の項目を選択すると、フレームワークによって呼び出されます。 |
|
親ツール バーが WM_HELPHITTEST メッセージを処理すると、フレームワークによって呼び出されます。 (CMFCToolBarButton::OnContextHelp をオーバーライドします。) |
|
指定されたスタイルとオプションを使用してボタンを描画するために、フレームワークによって呼び出されます。 (CMFCToolBarButton::OnDraw をオーバーライドします。) |
|
[ユーザー設定] ダイアログ ボックスの [コマンド] ペインにボタンを描画するために、フレームワークによって呼び出されます。 (CMFCToolBarButton::OnDrawOnCustomizeList をオーバーライドします。) |
|
ユーザーがポップアップ メニューを開くと、フレームワークによって呼び出されます。 |
|
ボタンに関連付けられるイメージに既定の値を設定します。 (CMFCToolBarButton::ResetImageToDefault をオーバーライドします。) |
|
ツール バー ボタンの状態を保存します。 (CMFCToolBarButton::SaveBarState をオーバーライドします。) |
|
このオブジェクトをアーカイブから読み取るか、アーカイブに書き込みます。 (CMFCToolBarButton::Serialize をオーバーライドします。) |
|
指定された CAccessibilityData オブジェクトをツール バー ボタンのアクセシビリティ データと共に設定します。 (CMFCToolBarButton::SetACCData をオーバーライドします。) |
|
ボタンをツール バーに追加できるかどうかを指定します。 |
|
ポップアップ メニューがパレット モードかどうかを指定します。 |
|
|
|
ツール バー メニュー ボタンに、そのボタンが選択されていることを示すアイコンを強制的に表示します。 |
|
ポップアップ メニューのティアオフ バー ID を指定します。 |
プロテクト メソッド
[名前] |
説明 |
---|---|
メニュー ボタンにアイコンを描画します。 |
データ メンバー
[名前] |
説明 |
---|---|
TRUE の場合は、ボタンが描画されると必ず、フレームワークが CFrameWndEx::OnDrawMenuImage を呼び出します。 |
解説
CMFCToolBarMenuButton は、メニュー、サブメニューのあるメニュー項目、コマンドを実行するかメニューを表示するボタン、またはメニューだけを表示するボタンとして表示されます。 メニュー ボタンの動作や外観を決定するには、イメージ、テキスト、メニュー ハンドル、コンストラクター CMFCToolbarMenuButton::CMFCToolbarMenuButton のボタンに関連付けられているコマンド ID などのパラメーターを指定します。
CMFCToolbarMenuButton クラスから派生したカスタム クラスでは、DECLARE_SERIAL マクロを使用する必要があります。 DECLARE_DYNCREATE マクロは、アプリケーションが終了するときにエラーを生成します。
使用例
CMFCToolBarMenuButton オブジェクトを構成する方法を次の例に示します。 このコードは、ドロップダウン メニューがパレット モードかどうかを指定する方法、およびユーザーがメニュー ボタンをメニュー バーの外にドラッグしたときに作成されるティアオフ バーの ID を指定する方法を示しています。 このコード スニペットは、「ワードパッドのサンプル:MFC ワードパッド アプリケーション」の一部です。
pBorderType->SetMenuPaletteMode (TRUE, 2 /* Rows number */);
pBorderType->SetTearOff (ID_BORDER_TEAROFF);
継承階層
必要条件
**ヘッダー:**afxtoolbarmenubutton.h