CMFCToolBarButton クラス
ツール バーのボタン機能を提供します。
class CMFCToolBarButton : public CObject
メンバー
.gif "Bb983678.collapse_all(ja-jp,VS.110).gif")
パブリック コンストラクター
名前 |
説明 |
|---|---|
CMFCToolBarButton オブジェクトを構築し、初期化します。 |
|
CMFCToolBarButton::~CMFCToolBarButton |
デストラクターです。 |
パブリック メソッド
名前 |
説明 |
|---|---|
カスタマイズの際、ユーザーがツール バーまたはメニューにボタンを配置できるかどうかを指定します。 |
|
ボタンを格納できるかどうかを指定します。 |
|
ユーザーがカスタマイズ中にボタンを引き伸ばせるかどうかを指定します |
|
指定された CMFCToolBarButton オブジェクトを、このインスタンスと比較します。 |
|
別のツール バー ボタンのプロパティを現在のボタンにコピーします。 |
|
指定した COleDataObject オブジェクトから CMFCToolBarButton オブジェクトを作成します。 |
|
CMFCToolBarButton::CreateObject |
このクラス型の動的インスタンスを作成するために、フレームワークによって使用されます。 |
マウス入力およびキーボード入力を許可または禁止します。 |
|
ツール バー ボタンのテキストをメニューにコピーします。 |
|
アプリケーションのグローバル クリップボード形式を取得します。 |
|
ツール バー ボタンに関連付けられたウィンドウ ハンドルを取得します。 |
|
ボタンのイメージのインデックスを取得します。 |
|
再描画する必要がある、ボタンのクライアント領域内での部分を取得します。 |
|
ボタンの親ウィンドウを取得します。 |
|
ユーザーがカスタマイズできないコマンドの一覧を取得します。 |
|
ボタン テキストのサイズを取得します。 |
|
ボタンに現在の入力フォーカスがあるかどうかを判断します。 |
|
ユーザーがボタンを選択したときに、ボタンの境界線を表示するかどうかを判定します |
|
ボタンにイメージが表示されるかどうかを判断します。 |
|
ボタンにテキスト ラベルを表示するかどうかを判断します。 |
|
ボタンがサブメニューを表示するかどうかを判断します。 |
|
ボタンをカスタマイズできるかどうかを判断します。 |
|
拡張された境界でボタンを表示できるかどうかを指定します。 |
|
ボタンがボタン グループの先頭にあるかどうかを判断します。 |
|
ボタンが非表示かどうかを判断します。 |
|
ボタンが水平方向のツール バーに配置されているかどうかを判断します。 |
|
そのボタンを、ボタン グループの末尾に配置するかどうかを指定します。 |
|
ボタンがロックされた (カスタマイズできない) ツール バー上にあるかどうかを判断します。 |
|
ボタンが、指定されたウィンドウ ハンドルのオーナーかどうかを判断します。 |
|
ツール バー ボタンが表示されているかどうかを判断します。 |
|
ボタンの基になるウィンドウ ハンドルが表示されているかどうかを判断します。 |
|
ボタンで WM_COMMAND メッセージを処理するかどうかを指定します。 |
|
ボタンが [カスタマイズ] ダイアログ ボックスに追加されたときに、フレームワークによって呼び出されます。 |
|
ボタンをドラッグできるかどうかを指定します。 |
|
ユーザーがボタンをターゲットのツール バーにドロップできるかどうかを指定します。 |
|
指定されたデバイス コンテキストとドッキングの状態に応じたボタンのサイズを計算するために、フレームワークによって呼び出されます。 |
|
WM_CANCELMODE メッセージを処理するために、フレームワークによって呼び出されます。 |
|
新しいツール バーにボタンが挿入されたときに、フレームワークによって呼び出されます。 |
|
ユーザーがマウス ボタンをクリックしたときに、フレームワークによって呼び出されます。 |
|
ユーザーがマウス ボタンを放すと、フレームワークによって呼び出されます。 |
|
親ツール バーが WM_HELPHITTEST メッセージを処理するときに、フレームワークによって呼び出されます。 |
|
親ツール バーが WM_CTLCOLOR メッセージを処理するときに、フレームワークによって呼び出されます。 |
|
アプリケーションが親ツール バーにショートカット メニューを表示する場合、指定されたメニューをボタンが変更できるようにします。 |
|
親ツール バーが WM_LBUTTONDBLCLK メッセージを処理するときに、フレームワークによって呼び出されます。 |
|
指定されたスタイルとオプションを使用してボタンを描画するために、フレームワークによって呼び出されます。 |
|
[カスタマイズ] ダイアログ ボックスの [コマンド] ペインにボタンを描画するために、フレームワークによって呼び出されます。 |
|
ボタンのカスタム ツールヒントのテキストを取得するために、フレームワークによって呼び出されます。 |
|
グローバル フォントが変更されたときに、フレームワークによって呼び出されます。 |
|
親ツール バーが移動されたときに、フレームワークによって呼び出されます。 |
|
ボタンが表示または非表示に切り替わったときに、フレームワークによって呼び出されます。 |
|
親ツール バーのサイズまたは位置が変更され、それに伴ってホタンのサイズを変更する必要がある場合に、フレームワークによって呼び出されます。 |
|
ボタンに外接する四角形内にポインターがあるかどうかを親ツール バーが判断する必要がある場合に、フレームワークによって呼び出されます。 |
|
親ツール バーが、そのツールヒント テキストを更新するときに、フレームワークによって呼び出されます。 |
|
ボタンがドラッグ アンド ドロップ操作を実行しようとすると、フレームワークによって呼び出されます。 |
|
ボタンの外接する四角形を取得します。 |
|
ボタンに関連付けられるイメージに既定の値を設定します。 |
|
ツール バー ボタンの状態を保存します。 |
|
このオブジェクトをアーカイブから読み取るか、アーカイブに書き込みます (CObject::Serialize をオーバーライドします。) |
|
指定された CAccessibilityData オブジェクトに、ツール バー ボタンのアクセシビリティ データを設定します。 |
|
グローバル クリップボード形式の名前を変更します。 |
|
ボタンのイメージのインデックスを設定します。 |
|
ユーザーがカスタマイズできないコマンドの一覧を設定します。 |
|
ボタンがオンになっている状態を変更したときに、フレームワークによって呼び出されます。 |
|
ボタンの外接する四角形を設定します。 |
|
ボタンのスタイルを設定します。 |
|
ボタンを表示するかどうかを指定します。 |
|
ボタンの表示、非表示を切り替えます。 |
データ メンバー
名前 |
説明 |
|---|---|
ボタンにイメージを表示するかどうかを指定します。 |
|
ボタンにテキスト ラベルを表示するかどうかを指定します。 |
|
ボタンのイメージの下にテキスト ラベルを表示するかどうかを指定します。 |
|
ボタンにユーザー定義のイメージがあるかどうかを指定します。 |
|
テキスト ラベルが外接する四角形に収まらない場合でもボタンにフル テキスト ラベルを表示するかどうかを指定します。 |
|
区切りの横のボタンが次の行に挿入されるかどうかを指定します。 |
|
複数行のテキスト ラベルを有効にするかどうかを指定します。 |
|
ボタンのコマンド ID。 |
|
ボタンのスタイル。 |
|
ボタンのテキスト ラベル。 |
解説
CMFCToolbarButton オブジェクトはツール バー上にあるコントロールです。その動作は通常のボタンの動作に似ています。このオブジェクトには、イメージとテキスト ラベルを割り当てることができます。ツール バー ボタンはコマンド ID を持つこともできます。ユーザーがツール バー ボタンをクリックすると、フレームワークは、この ID で指定されるコマンドを実行します。
通常、ツール バー ボタンはカスタマイズできます。ユーザーは 1 つのツール バーから別のツール バーにボタンをドラッグし、テキスト ラベルとイメージをコピー、貼り付け、削除、および編集することができます。ユーザーがツール バーをカスタマイズできないようにするために、ツール バーをロックできます。そのためには、CMFCToolBar::LoadToolBar を呼び出すときに bLocked フラグを TRUE に設定するか、または CMFCToolBarButton::SetProtectedCommands メソッドを使用して保護されたコマンドのグローバル リストに個別のボタンのコマンド ID を追加します。
CMFCToolBarButton オブジェクトは、ツール バー イメージのグローバル コレクションのイメージをアプリケーションに表示します。これらのコレクションは、親ツール バー CMFCToolBar クラスによって保持されます。詳細については、「CMFCToolBarImages クラス」を参照してください。
ユーザーがツール バー ボタンをクリックすると、その親ツール バーは、マウス メッセージを処理して適切なアクションをボタンに伝えます。ボタンに有効なコマンド ID があれば、親ツール バーは親フレームに WM_COMMAND メッセージを送信します。
CMFCToolBarButton クラスは、CMFCToolBarMenuButton クラス、CMFCToolBarEditBoxButton クラス、および CMFCToolBarComboBoxButton クラスなど、他のツール バー ボタン クラスの基本クラスです。
使用例
CMFCToolBarButton クラスのさまざまなメソッドを使用して CMFCToolBarButton オブジェクトを構成する方法を次の例に示します。また、マウスおよびキーボードの入力を有効にし、ボタンのイメージ インデックスを設定し、ボタンに外接した四角形を設定し、ボタンを表示する方法も示します。このコード スニペットは タブ コントロールのサンプルの一部です。
CMFCToolBarButton* pOffice2007 = NULL;
int nIndex = -1;
for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
{
// CMFCToolBar m_wndToolBarTheme
nIndex = m_wndToolBarTheme.CommandToIndex (uiCmd);
CMFCToolBarButton* pButton = m_wndToolBarTheme.GetButton (nIndex);
if (pButton != NULL)
{
pOffice2007 = pButton;
break;
}
}
...
pOffice2007->EnableWindow();
pOffice2007->SetImage(1);
pOffice2007->SetRect( CRect(1,1,1,1));
pOffice2007->SetVisible();
pOffice2007->Show(true);
継承階層
必要条件
ヘッダー : afxtoolbarbutton.h
参照
関連項目
CMFCToolBarButton::NotifyCommand