次の方法で共有

ツール バー

  • [アーティクル]

このセクションでは、ツールバー コントロールで使用されるプログラミング要素について説明します。

概要

トピック 内容
ツール バー コントロールについて ツールバーは、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 を使用するには、マニフェストで指定します。 マニフェストの詳細については、「ビジュアル スタイルを有効にする」を参照してください。
ツール バーの拡張スタイル このセクションでは、ツールバー コントロールでサポートされる拡張スタイルを一覧します。
ツール バーの標準ボタン イメージのインデックス値 このセクションでは、標準ビットマップ内のイメージのインデックス値を指定します。