次の方法で共有

ツールバー

  • [アーティクル]

このセクションには、ツール バー コントロールで使用されるプログラミング要素に関する情報が含まれています。

概要

話題 内容
ツールバー コントロールの について ツール バーは、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 ポインターがボタンの 1 つを通過したときに、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 メッセージが格納され、ツール バーの状態に関する情報を取得するレジストリ内の場所を指定します。

定数

話題 内容
ツール バー ボタンの状態 このセクションでは、ツール バー ボタンで使用できる状態の一覧を示します。
ツール バー コントロールとボタン のスタイル 次のウィンドウ スタイルは、ツール バーに固有です。 これらは、ツール バーの作成時に他のウィンドウ スタイルと組み合わされます。
メモ バージョン 6.00 の共通コントロールの場合、表示スタイルの がツール バーで使用されている場合、ボタンはスタイルの設定に関係なく常に透明になります。 それ以外の場合、透明度の動作は、TBSTYLE_FLAT または TBSTYLE_TRANSPARENT スタイルの使用によって示される通常の動作です。 注: Comctl32.dll バージョン 6 は再頒布可能ではありませんが、Windows 以降に含まれています。 バージョン 6 Comctl32.dll 使用するには、マニフェストで指定します。 マニフェストの詳細については、「Visual Stylesを有効にする」を参照してください。
ツール バーの拡張スタイル このセクションでは、ツール バー コントロールでサポートされる拡張スタイルの一覧を示します。
ツール バーの [標準] ボタンの画像のインデックス値 このセクションでは、標準ビットマップ内のイメージのインデックス値を指定します。