ツール バー
このセクションでは、ツールバー コントロールで使用されるプログラミング要素について説明します。
概要
| トピック | 内容 |
|---|---|
| ツール バー コントロールについて | ツールバーは、1 つ以上のボタンを含むコントロールです。 ユーザーが各ボタンをクリックすると、親ウィンドウにコマンド メッセージを送信します。 通常、ツール バーのボタンは、アプリケーションのメニュー内の項目に対応し、ユーザーがアプリケーションのコマンドにアクセスするための追加のより直接的な方法を提供します。 |
| ツール バー コントロールの使用 | このトピックには、アプリケーションでツールバー コントロールを使用するための実装の詳細とコード例が含まれています。 |
関数
| トピック | 内容 |
|---|---|
| CreateMappedBitmap | ツールバーで使用するビットマップを作成します。 |
| CreateToolbarEx | ツールバー ウィンドウを作成し、指定したボタンをツールバーに追加します。 注: この関数は、ツールバーのすべての機能をサポートしているわけではないため、非推奨です。 代わりに CreateWindowEx を使用します。 例については、「ツールバー コントロールの使用」を参照してください。 |
[メッセージ]
| トピック | 内容 |
|---|---|
| TB_ADDBITMAP | ツールバーで使用できるボタン イメージの一覧に 1 つ以上の画像を追加します。 |
| TB_ADDBUTTONS | ツールバーに 1 つ以上のボタンを追加します。 |
| TB_ADDSTRING | ツールバーの文字列プールに新しい文字列を追加します。 |
| TB_AUTOSIZE | ツールバーのサイズを変更します。 |
| TB_BUTTONCOUNT | 現在ツールバーにあるボタン数を取得します。 |
| TB_BUTTONSTRUCTSIZE | TBBUTTON 構造体のサイズを指定します。 |
| TB_CHANGEBITMAP | ツールバーのボタンのビットマップを変更します。 |
| TB_CHECKBUTTON | ツール バーの特定のボタンのチェックをオンにするかオフにします。 |
| TB_COMMANDTOINDEX | 指定したコマンド識別子に関連付けられているボタンの 0 から始まるインデックスを取得します。 |
| TB_CUSTOMIZE | [ツールバーのカスタマイズ] ダイアログ ボックスを表示します。 |
| TB_DELETEBUTTON | ツールバーからボタンを削除します。 |
| TB_ENABLEBUTTON | ツール バーの指定したボタンを有効または無効にします。 |
| TB_GETANCHORHIGHLIGHT | ツールバーのアンカー強調表示設定を取得します。 |
| TB_GETBITMAP | ツールバーのボタンに関連付けられているビットマップのインデックスを取得します。 |
| TB_GETBITMAPFLAGS | 使用するビットマップの種類を記述するフラグを取得します。 |
| TB_GETBUTTON | ツールバーの指定したボタンに関する情報を取得します。 |
| TB_GETBUTTONINFO | ツールバーのボタンの拡張情報を取得します。 |
| TB_GETBUTTONSIZE | ツールバー ボタンの現在の幅と高さをピクセル単位で取得します。 |
| TB_GETBUTTONTEXT | ツールバーのボタンの表示テキストを取得します。 |
| TB_GETCOLORSCHEME | ツールバー コントロールからカラー スキーム情報を取得します。 |
| TB_GETDISABLEDIMAGELIST | ツールバー コントロールが非アクティブなボタンを表示するために使用するイメージ リストを取得します。 |
| TB_GETEXTENDEDSTYLE | ツールバー コントロールの拡張スタイルを取得します。 |
| TB_GETHOTIMAGELIST | ツールバー コントロールがホット ボタンを表示するために使用するイメージ リストを取得します。 |
| TB_GETHOTITEM | ツールバーのホット アイテムのインデックスを取得します。 |
| TB_GETIDEALSIZE | ツールバーの理想的なサイズを取得します。 |
| TB_GETIMAGELIST | ツールバー コントロールがボタンを既定の状態で表示するために使用するイメージ リストを取得します。 ツールバー コントロールでは、このイメージ リストを使用して、ボタンがホットでない場合や無効になっている場合にボタンを表示します。 |
| TB_GETIMAGELISTCOUNT | ツールバーに関連付けられているイメージ リスト数を取得します。 |
| TB_GETINSERTMARK | ツールバーの現在の挿入マークを取得します。 |
| TB_GETINSERTMARKCOLOR | ツールバーの挿入マークの描画に使用する色を取得します。 |
| TB_GETITEMDROPDOWNRECT | スタイル BTNS_DROPDOWN のツールバー アイテムに対するドロップダウン ウィンドウの外接矩形を取得します。 |
| TB_GETITEMRECT | ツールバーのボタンの外接矩形を取得します。 |
| TB_GETMAXSIZE | ツールバーに表示されているすべてのボタンと区切り記号の合計サイズを取得します。 |
| TB_GETMETRICS | ツールバー コントロールのメトリックを取得します。 |
| TB_GETOBJECT | ツールバー コントロールの IDropTarget を取得します。 |
| TB_GETPADDING | ツールバー コントロールの余白を取得します。 |
| TB_GETPRESSEDIMAGELIST | ツールバー コントロールが押された状態のボタンを表示するために使用するイメージ リストを取得します。 |
| TB_GETRECT | 指定したツールバー ボタンの外接矩形を取得します。 |
| TB_GETROWS | TBSTYLE_WRAPABLE スタイルを持つツールバー内のボタンの行数を取得します。 |
| TB_GETSTATE | ツールバーの指定したボタンの状態に関する情報 (有効、押された、またはチェックされているかどうかなど) を取得します。 |
| TB_GETSTRING | ツール バーの文字列プールから文字列を取得します。 |
| TB_GETSTYLE | ツールバー コントロールに現在使用されているスタイルを取得します。 |
| TB_GETTEXTROWS | ツールバー ボタンに表示できるテキスト行の最大数を取得します。 |
| TB_GETTOOLTIPS | ツールバーに関連付けられているツールヒント コントロール (存在する場合) へのハンドルを取得します。 |
| TB_GETUNICODEFORMAT | コントロールの Unicode 文字形式フラグを取得します。 |
| TB_HASACCELERATOR | 内部使用を目的としたものであり、アプリケーションでの使用は推奨されません。 指定したアクセラレータ文字を持つツールバー ボタン数を取得します。 |
| TB_HIDEBUTTON | ツール バーの指定したボタンを表示または非表示にします。 |
| TB_HITTEST | ツールバー コントロール内のポイントの位置を決定します。 |
| TB_INDETERMINATE | ツール バーの指定されたボタンの不確定な状態を設定またはクリアします。 |
| TB_INSERTBUTTON | ツールバーにボタンを挿入します。 |
| TB_INSERTMARKHITTEST | ツールバー内のポイントの挿入マーク情報を取得します。 |
| TB_ISBUTTONCHECKED | ツールバーの指定したボタンがチェックされているかどうかを判断します。 |
| TB_ISBUTTONENABLED | ツールバーの指定したボタンが有効かどうかを判断します。 |
| TB_ISBUTTONHIDDEN | ツールバーの指定したボタンが非表示かどうかを判断します。 |
| TB_ISBUTTONHIGHLIGHTED | ツールバー ボタンの強調表示の状態を確認します。 |
| TB_ISBUTTONINDETERMINATE | ツールバーの指定したボタンが未確定かどうかを判断します。 |
| TB_ISBUTTONPRESSED | ツールバーの指定したボタンが押されているかどうかを判断します。 |
| TB_LOADIMAGES | システム定義のボタン イメージをツールバー コントロールのイメージ リストに読み込みます。 |
| TB_MAPACCELERATOR | 指定したアクセラレータ文字に対応するボタンの ID を決定します。 |
| TB_MARKBUTTON | ツール バー コントロールの特定のボタンの強調表示の状態を設定します。 |
| TB_MOVEBUTTON | あるインデックスから別のインデックスにボタンを移動します。 |
| TB_PRESSBUTTON | ツール バーの指定したボタンを押すか離します。 |
| TB_REPLACEBITMAP | 既存のビットマップを新しいビットマップに置き換えます。 |
| TB_SAVERESTORE | このメッセージを送信して、ツールバーの状態の保存または復元を開始します。 |
| TB_SETANCHORHIGHLIGHT | ツールバーのアンカー強調表示設定を設定します。 |
| TB_SETBITMAPSIZE | ツールバーに追加するビットマップ イメージのサイズを設定します。 |
| TB_SETBOUNDINGSIZE | 内部使用を目的としたものであり、アプリケーションでの使用は推奨されません。 複数列のツールバー コントロールの境界サイズを設定します。 |
| TB_SETBUTTONINFO | ツールバーの既存のボタンの情報を設定します。 |
| TB_SETBUTTONSIZE | ツール バーのボタンのサイズを設定します。 |
| TB_SETBUTTONWIDTH | ツール バー コントロールのボタンの最小幅と最大幅を設定します。 |
| TB_SETCMDID | ツールバー ボタンのコマンド識別子を設定します。 |
| TB_SETCOLORSCHEME | ツールバー コントロールのカラー スキーム情報を設定します。 |
| TB_SETDISABLEDIMAGELIST | ツールバー コントロールが無効なボタンを表示するために使用するイメージ リストを設定します。 |
| TB_SETDRAWTEXTFLAGS | ツールバーのテキスト描画フラグを設定します。 |
| TB_SETEXTENDEDSTYLE | ツールバー コントロールの拡張スタイルを設定します。 |
| TB_SETHOTIMAGELIST | ツールバー コントロールがホット ボタンを表示するために使用するイメージ リストを設定します。 |
| TB_SETHOTITEM | ツールバーのホット アイテムを設定します。 |
| TB_SETHOTITEM2 | ツールバーのホット アイテムを設定します。 |
| TB_SETIMAGELIST | ツール バーで既定の状態のボタンを表示するために使用するイメージ リストを設定します。 |
| TB_SETINDENT | ツールバー コントロールの最初のボタンのインデントを設定します。 |
| TB_SETINSERTMARK | ツールバーの現在の挿入マークを設定します。 |
| TB_SETINSERTMARKCOLOR | ツールバーの挿入マークの描画に使用する色を設定します。 |
| TB_SETLISTGAP | 特定のツールバーのツールバー ボタン間の距離を設定します。 |
| TB_SETMAXTEXTROWS | ツールバー ボタンに表示されるテキスト行の最大数を設定します。 |
| TB_SETMETRICS | ツールバー コントロールのメトリックを設定します。 |
| TB_SETPADDING | ツールバー コントロールのパディングを設定します。 |
| TB_SETPARENT | ツールバー コントロールが通知コードを送信するウィンドウを設定します。 |
| TB_SETPRESSEDIMAGELIST | ツール バーのボタンを押された状態で表示するために使用される画像のリストを設定します。 |
| TB_SETROWS | ツールバーのボタンの行数を設定します。 |
| TB_SETSTATE | ツール バーの指定したボタンの状態を設定します。 |
| TB_SETSTYLE | ツールバー コントロールのスタイルを設定します。 |
| TB_SETTOOLTIPS | ツールヒント コントロールをツールバーに関連付けます。 |
| TB_SETUNICODEFORMAT | コントロールの Unicode 文字形式フラグを設定します。 このメッセージを使用すると、コントロールを再作成する必要なく、コントロールで使用される文字セットを実行時に変更できます。 |
| TB_SETWINDOWTHEME | ツールバー コントロールのビジュアル スタイルを設定します。 |
| TB_TRANSLATEACCELERATOR | キーボード メッセージをツールバーに渡します。 |
通知
| トピック | 内容 |
|---|---|
| NM_CHAR (ツール バー) | WM_CHAR メッセージを受信したときにツールバーが送信します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| NM_CLICK (ツール バー) | ユーザーがマウスの左ボタンでアイテムをクリックしたときに、ツールバー コントロールが送信します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| NM_CUSTOMDRAW (ツール バー) | 描画操作について親ウィンドウに通知するために、ツールバーが送信します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| NM_DBLCLK (ツール バー) | ユーザーが、コントロール内のマウスの左ボタンをダブルクリックしたことをツールバー コントロールの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| NM_KEYDOWN (ツール バー) | コントロールにキーボード フォーカスがあり、ユーザーがキーを押したときに、コントロールによって送信されます。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| NM_LDOWN | マウスの左ボタンが押されたことを、ツールバーの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| NM_RCLICK (ツール バー) | ユーザーがマウスの右ボタンでツールバーをクリックしたときに、ツールバー コントロールが送信します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| NM_RDBLCLK (ツール バー) | ユーザーがコントロール内でマウスの右ボタンをダブルクリックしたことを、コントロールの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| NM_RELEASEDCAPTURE (ツール バー) | コントロールがマウス キャプチャを解放しようとしていることを、ツールバー コントロールの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| NM_TOOLTIPSCREATED (ツール バー) | ツールバーがヒント コントロールを作成したことを、ツールバーの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_BEGINADJUST | ユーザーがツールバーのカスタマイズを開始したことを、ツールバーの親ウィンドウに通知します。 このメッセージ コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_BEGINDRAG | ユーザーがツールバーのボタンのドラッグを開始したことを、ツールバーの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_CUSTHELP | ツールバーの親ウィンドウに、ユーザーが [ツールバーのカスタマイズ] ダイアログ ボックスで [ヘルプ] ボタンを選択したことを通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_DELETINGBUTTON | ボタンが削除されるときに、ツールバー コントロールが送信します。 |
| TBN_DRAGOUT | ユーザーがボタンをクリックし、カーソルをボタンから外したときに、ツールバー コントロールが送信します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_DRAGOVER | ドラッグされたボタンに対して TB_MARKBUTTON メッセージを送信する必要があるかどうかを確定します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_DROPDOWN | ユーザーがドロップダウン ボタンをクリックしたときに、ツールバー コントロールが送信します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_DUPACCELERATOR | 2 つ以上のアクティブなツールバーでアクセラレータ キーを使用できるかどうかを確定します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_ENDADJUST | ユーザーがツールバーのカスタマイズを停止したことを、ツールバーの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_ENDDRAG | ユーザーがツールバーのボタンのドラッグを停止したことを、ツールバーの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_GETBUTTONINFO | ツールバーのカスタマイズ情報を取得し、ツールバーに加えられた変更をツールバーの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_GETDISPINFO | ツールバー アイテムの表示情報を取得します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_GETINFOTIP | ツールバーアイテムのヒント情報を取得します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_GETOBJECT | ポインターがそのボタンのいずれかを通過した際に、ドロップ対象物を要求するために TBSTYLE_REGISTERDROP スタイルを使用するツールバー コントロールが送信します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_HOTITEMCHANGE | ホット (強調表示) アイテムが変更されたときに、ツールバー コントロールが送信します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_INITCUSTOMIZE | カスタマイズが開始されたことをツールバーの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_MAPACCELERATOR | 指定したアクセラレータ文字に対応するツールバーのボタンのインデックスを要求します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_QUERYDELETE | ユーザーがツールバーをカスタマイズしているときにボタンをツールバーから削除できるかどうかを、ツールバーの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_QUERYINSERT | ユーザーがツールバーをカスタマイズしているときに、指定したボタンの左側にボタンを挿入できるかどうかを、ツールバーの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_RESET | ユーザーが [ツールバーのカスタマイズ] ダイアログ ボックスの内容をリセットしたことを、ツールバーの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_RESTORE | ツールバーの親ウィンドウに、ツールバーが復元中であることを通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_SAVE | ツールバーの親ウィンドウに、ツールバーが保存中であることを通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_TOOLBARCHANGE | ユーザーがツールバーをカスタマイズしたことを、ツールバーの親ウィンドウに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_WRAPACCELERATOR | 指定したアクセラレータ文字に対応する 1 つ以上のツールバーのボタンのインデックスを要求します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| TBN_WRAPHOTITEM | 2 つ以上のツールバーを持つアプリケーションに、ホット アイテムが変更されようとしていることを通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
構造体
| トピック | 内容 |
|---|---|
| COLORMAP | ビットマップの色を マップするために CreateMappedBitmap 関数が使用する情報を含めます。 |
| NMTBCUSTOMDRAW | ツールバー コントロールが送信する NM_CUSTOMDRAW 通知コード固有の情報を含みます。 |
| NMTBDISPINFO | ツールバー アイテムの表示情報を格納および受信します。 この構造体は、TBN_GETDISPINFO 通知コードと併用されます。 |
| NMTBGETINFOTIP | ツールバー アイテムのヒント情報を格納および受信します。 この構造体は、TBN_GETINFOTIP 通知コードと併用されます。 |
| NMTBHOTITEM | TBN_HOTITEMCHANGE 通知コードで使用される情報が含まれます。 |
| NMTBRESTORE | ツールバーの状態が保存されたときに NMTBSAVE に配置された情報をアプリケーションが抽出できるようにします。 この構造体は、TBN_RESTORE 通知コードを受け取ったときにアプリケーションに渡されます。 |
| NMTBSAVE | この構造体は、TBN_SAVE 通知コードを受け取ったときにアプリケーションに渡されます。 現在保存されているボタンに関する情報が含まれています。 アプリケーションは、メンバーの値を変更して追加情報を保存できます。 |
| NMTOOLBAR | ツールバーの通知コードを処理するために使用する情報が含まれます。 この構造体は、TBNOTIFY 構造体より優先されます。 |
| TBADDBITMAP | ボタンのイメージを含むビットマップをツールバーに追加します。 |
| TBBUTTON | ツールバーのボタンに関する情報が含まれます。 |
| TBBUTTONINFO | ツールバーの特定のボタンの情報を格納または受信します。 |
| TBINSERTMARK | ツールバー コントロールの挿入マークに関する情報を格納します。 |
| TBMETRICS | ツールバー アイテムを縮小または展開するために使用するツールバーのメトリックを定義します。 |
| TBREPLACEBITMAP | 1 つのツールバー ビットマップを別のツールバー ビットマップに置き換えるために、TB_REPLACEBITMAP メッセージと併用されます。 |
| TBSAVEPARAMS | TB_SAVERESTORE メッセージが格納され、ツールバーの状態に関する情報を取得するレジストリ内の場所を指定します。 |
定数
| トピック | 内容 |
|---|---|
| ツール バー ボタンの状態 | このセクションでは、ツールバー ボタンで使用できる状態の一覧を示します。 |
| ツール バー コントロールとボタンのスタイル | 次のウィンドウ スタイルは、ツールバー専用です。 これらは、ツールバーの作成時に他のウィンドウ スタイルと組み合わされます。 注: Common Controls バージョン 6.00 では、ツールバーでビジュアル スタイルが使用されている場合、ボタンはスタイル設定に関係なく常に透明になります。 それ以外の場合、透明度の動作は、TBSTYLE_FLAT または TBSTYLE_TRANSPARENT スタイルの使用によって示される通常の動作です。 注: Comctl32.dll バージョン 6 は再頒布可能ではありませんが、Windows 以降に含まれています。 Comctl32.dll バージョン 6 を使用するには、マニフェストで指定します。 マニフェストの詳細については、「ビジュアル スタイルを有効にする」を参照してください。 |
| ツール バーの拡張スタイル | このセクションでは、ツールバー コントロールでサポートされる拡張スタイルを一覧します。 |
| ツール バーの標準ボタン イメージのインデックス値 | このセクションでは、標準ビットマップ内のイメージのインデックス値を指定します。 |