CToolBarCtrl: カスタマイズ通知の処理

Windows ツールバーコモンコントロールは、挿入、削除、またはツールバーのボタンを再配置すること、システム定義のカスタムダイアログボックスなど組み込みのカスタマイズ機能を備えています。アプリケーションのカスタマイズ機能が提供されをユーザーがツールバーをカスタマイズすることができますの範囲を制御するかどうかを決定します。

これらのカスタマイズ機能をユーザーにツールバーにCCS_ADJUSTABLEスタイルを与えることによって利用できます。カスタマイズ機能ボタンを新しい位置にドラッグしたり、ボタンをツールバーからドラッグして削除すること。さらに、ユーザーを追加、削除、およびツールバーのボタンを再配置するには、ユーザーが [ツールバーのカスタマイズ] ダイアログボックスを表示するツールバーをダブルクリックできます。アプリケーションは、 Customizeメンバー関数を使用してダイアログボックスを表示することができます。

ツールバーコントロールを親ウィンドウのカスタマイズプロセスの各手順で通知メッセージを送信します。ユーザー SHIFT キー押しボタンのドラッグを開始する場合、ツールバーは自動的にドラッグ操作を処理します。ツールバー、ボタンを削除することがあるかどうかを確認するのには、親ウィンドウにTBN_QUERYDELETE通知メッセージを送信します。親ウィンドウがFALSEを返す場合は、ドラッグ操作を終了します。それ以外の場合、ツールバーマウス入力をキャプチャし、ユーザーがマウスボタンを解放するまで待機。

マウスボタンを離すと、ツールバーコントロールは、マウスカーソルの位置を決定します。カーソルがツールバーの外側にある場合、ボタンは削除されます。カーソルが別のツールバー上の場合は、ツールバーはTBN_QUERYINSERT通知メッセージを特定のボタンの左側にボタンを挿入できるかどうを確認するのには、親ウィンドウを送信します。親ウィンドウがTRUEを返す場合、ボタンが挿入されます。それ以外の場合、これではありません。ツールバーをドラッグ操作の終了を通知するには、 TBN_TOOLBARCHANGE通知メッセージを送信します。

ユーザーは、SHIFT キーを押しせずドラッグ操作の開始には、ツールバーコントロール、オーナーウィンドウにTBN_BEGINDRAG通知メッセージを送信します。独自のボタンドラッグコードを実装するアプリケーションこのメッセージは、シグナルとしてを使用して、ドラッグ操作を開始できます。ツールバーをドラッグ操作の終了を通知するには、 TBN_ENDDRAG通知メッセージを送信します。

[ツールバーのカスタマイズ] ダイアログボックスを使用して、ツールバー、ユーザーをカスタマイズするとき、ツールバーコントロール通知メッセージを送信します。ツールバー、ツールバーをダブルクリックする前にダイアログボックスが作成された後、 TBN_BEGINADJUST通知メッセージを送信します。次に、ツールバーはTBN_QUERYINSERT通知メッセージ、ツールバーボタンを挿入することができるかどうかを確認するのには、一連の送信を開始します。親ウィンドウがTRUEを返す場合は、ツールバーはTBN_QUERYINSERT通知メッセージの送信を停止します。親ウィンドウTRUEはボタンを返さない場合、ダイアログボックス、ツールバーを破棄します。

次に、ツールバーコントロールは、ボタンをツールバーのボタンごとにTBN_QUERYDELETE通知メッセージを送信することによって、ツールバーから削除できるかどうを決定します。親ウィンドウは、ボタンを削除することがあることを示すためにTRUEを返します。それ以外の場合はFALSEを返します。ツールバーのすべてのツールバーボタン、ダイアログボックスに追加しますが、削除できない淡色表示。

ツールバーを [ツールバーのカスタマイズ] ダイアログボックスのボタンについての情報を必要なときに、それは、情報が必要なボタンのインデックスと、 TBNOTIFY構造体のアドレスを指定する、 TBN_GETBUTTONINFO通知メッセージを送信します。親ウィンドウ構造の関連情報を入力する必要があります。

[ツールバーのカスタマイズ] ダイアログボックスには、[ヘルプ] ボタンとリセットボタンが含まれています。ユーザーが [ヘルプ] ボタンを選択した場合は、ツールバーコントロール、 TBN_CUSTHELP通知メッセージを送信します。親ウィンドウは、ヘルプ情報を表示することによって対応する必要があります。リセットボタンは、ユーザーを選択すると、ダイアログボックスはTBN_RESET通知メッセージを送信します。ツールバーについて] ダイアログボックスを再初期化するにはこのメッセージをシグナルします。

これらのメッセージすべてのWM_NOTIFYメッセージとは、オーナーウィンドウのメッセージマップエントリを次の形式のオーナーウィンドウのメッセージマップに追加処理できます。:

ON_NOTIFY ( wNotifyCode, idControl, memberFxn ）

wNotifyCode

通知メッセージの識別子コードは、 TBN_BEGINADJUSTなど。

idControl

通知を送るコントロールの識別子。

memberFxn

この通知を受け取ったときに呼び出されるメンバー関数。

メンバー関数は、次のプロトタイプを宣言するだろう:

afx_msg void memberFxn( NMHDR ※ pNotifyStruct, LRESULT ※ 結果 );

通知メッセージのハンドラーが返された場合は、それは結果で指すLRESULTで置くべき。

各メッセージには、 pNotifyStructはNMHDR構造体またはTBNOTIFY構造体のいずれかをポイントします。これらの構造を説明します。:

NMHDR構造体に次のメンバーが含まれています:

typedef 構造体 tagNMHDR {HWND hwndFrom; 特価;//メッセージを送信するコントロールのハンドルUINT idFrom; ・ ・ コントロールの識別子を送信メッセージUINT コード;//通知コード;下記参照} NMHDR(&N)

hwndFrom

通知を送るコントロールのウィンドウハンドル。このハンドルはCWndのポインターに変換するには、 CWnd::FromHandleを使用します。

idFrom

通知を送るコントロールの識別子。

コード

通知コード。このメンバー値TTN_NEEDTEXT、 TBN_BEGINADJUSTなどのコントロールの種類を特定することができます。またはそれ以下の一般的な通知の値の 1 つをすることができます。:

NM_CLICK特価;ユーザーがコントロール内でマウスの左ボタンをクリックしました。(&N)。
NM_DBLCLK特価;ユーザーがコントロール内でマウスの左ボタンをダブルクリックしました(&N)。
NM_KILLFOCUS特価;コントロールが入力フォーカスを失った(&N)。
NM_OUTOFMEMORY特価;利用可能な十分なメモリがないため、制御、操作を完了できません。(&N)。
NM_RCLICK特価;ユーザーがコントロール内でマウスの右ボタンをクリックしました。(&N)。
NM_RDBLCLK特価;ユーザーがコントロール内でマウスの右ボタンをダブルクリックしました(&N)。
NM_RETURN特価;コントロールに入力フォーカスがあるし、ユーザーが ENTER キー押されました。(&N)。
NM_SETFOCUS特価;コントロールが入力フォーカスを受け取りました(&N)。

TBNOTIFY構造の次のメンバーを含む:

typedef 構造体 {NMHDR hdr;//すべての WM_NOTIFY メッセージに共通の情報int iItem;//ボタンのインデックス関連の通知TBBUTTON tbButton;//ボタンについての情報の通知に関連付けられています。int cchText; 特価;//ボタンのテキスト内の文字の数LPSTR lpszText;/アドレス ボタンのテキスト} TBNOTIFY、これまで ※ LPTBNOTIFY(&N)

hdr

すべてのWM_NOTIFYメッセージに共通の情報。

iItem

通知に関連付けられたボタンのインデックス。

tbButton

通知に関連付けられたツールバーボタンに関する情報を含むTBBUTTON構造体。

cchText

ボタンのテキストの文字数。

lpszText

ボタンのテキストへのポインター。

ツールバーが送る通知は次のとおりです。:

TBN_BEGINADJUST特価;ツールバーコントロールのカスタマイズ、ユーザーの開始時に送信されます。ポインターは通知についての情報が含まれています、 NMHDR構造体を指します。ハンドラーが特定の値を返す必要はありません。(&N)。
TBN_BEGINDRAG特価;ユーザーボタンをツールバーコントロールのドラッグを開始するときに送信されます。TBNOTIFY構造体へのポインターポインター。IItemメンバーには、ドラッグされているボタンの 0 から始まるインデックスが含まれています。ハンドラーが特定の値を返す必要はありません。(&N)。
TBN_CUSTHELP特価;ユーザーが [ツールバーのカスタマイズ] ダイアログボックスで [ヘルプ] ボタンを選択するときに送信されます。戻り値はありません。通知メッセージの情報が含まれています、 NMHDR構造体へのポインターポインター。ハンドラーが特定の値を返す必要はありません。(&N)。
TBN_ENDADJUST特価;ツールバーコントロールをカスタマイズする、ユーザーを停止したときに送信されます。通知メッセージの情報が含まれています、 NMHDR構造体へのポインターポインター。ハンドラーが特定の値を返す必要はありません。(&N)。
TBN_ENDDRAG特価;ツールバーコントロールにボタンをドラッグ、ユーザーを停止したときに送信されます。TBNOTIFY構造体へのポインターポインター。IItemメンバーには、ドラッグされているボタンの 0 から始まるインデックスが含まれています。ハンドラーが特定の値を返す必要はありません。(&N)。
TBN_GETBUTTONINFO特価;ユーザーがツールバーコントロールをカスタマイズしているときに送信されます。ツールバーでは、この通知メッセージを使用して [ツールバーのカスタマイズ] ダイアログボックスで必要な情報を取得します。TBNOTIFY構造体へのポインターポインター。IItemメンバーには、ボタンの 0 から始まるインデックスを指定します。PszTextとcchTextのメンバー、アドレスと長さは現在のボタンのテキストの文字を指定します。アプリケーションボタンについての情報を構造体を埋める必要があります。ボタンの情報は、構造体、またはFALSEにそれ以外の場合コピーされた場合、TRUEを返します(&N)。
TBN_QUERYDELETE特価;ユーザーツールバーコントロールからボタンを削除可能性があるかどうかを確認するのには、ツールバーをカスタマイズしている間を送信します。TBNOTIFY構造体へのポインターポインター。IItemメンバーには、削除するボタンの 0 から始まるインデックスが含まれています。ボタンの削除を許可するTRUEまたは削除から、ボタンを禁止するFALSEを返す(&N)。
TBN_QUERYINSERT特価;ユーザー特定のボタンの左側にボタンが挿入される可能性があるかどうかを確認するのには、ツールバーコントロールをカスタマイズしている間を送信します。TBNOTIFY構造体へのポインターポインター。IItemメンバーには、挿入するボタンの 0 から始まるインデックスが含まれています。特定のボタンの前に挿入するためのボタンを許可するTRUEまたはボタンの挿入を防止するにはFALSEを返す(&N)。
TBN_RESET特価;[ツールバーのカスタマイズ] ダイアログボックスの内容をユーザーがリセットされたときに送信されます。通知メッセージの情報が含まれています、 NMHDR構造体へのポインターポインター。ハンドラーが特定の値を返す必要はありません。(&N)。
TBN_TOOLBARCHANGE特価;ユーザーがツールバーコントロールをカスタマイズが後を送信します。通知メッセージの情報が含まれています、 NMHDR構造体へのポインターポインター。ハンドラーが特定の値を返す必要はありません。(&N)。

Index