カスタマイズ通知の処理
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を返します。 ツール バーはすべてのツール バー ボタンをダイアログ ボックスに追加しますが、削除できないボタンは淡色表示します。
ツール バー コントロールは、[ツール バーのカスタマイズ] ダイアログ ボックスのボタンに関する情報が必要になると、 TBN_GETBUTTONINFO 通知メッセージを送り、情報が必要なボタンのインデックスと TBNOTIFY 構造体のアドレスを指定します。 親ウィンドウは構造体に適切な情報を格納する必要があります。
[ツール バーのカスタマイズ] ダイアログ ボックスには、[ヘルプ] ボタンと [リセット] ボタンがあります。 ユーザーが [ヘルプ] ボタンを選ぶと、ツール バー コントロールは TBN_CUSTHELP 通知メッセージを送信します。 親ウィンドウは、ヘルプ情報を表示して応答する必要があります。 ユーザーが [リセット] ボタンを選ぶと、ダイアログ ボックスは TBN_RESET 通知メッセージを送信します。 このメッセージは、ツール バーがダイアログ ボックスを再初期化しようとしていることを示します。
これらのメッセージはすべて WM_NOTIFY メッセージです。メッセージをオーナー ウィンドウで処理するには、オーナー ウィンドウのメッセージ マップに次のような形式でメッセージ マップのエントリを追加します。
ON_NOTIFY( wNotifyCode, idControl, memberFxn )
wNotifyCode
通知メッセージの識別子コード。 TBN_BEGINADJUSTなど。
idControl
通知を送信するコントロールの識別子。
memberFxn
この通知を受信したときに呼び出されるメンバー関数。
メンバー関数は次のプロトタイプで宣言されます。
afx_msg void memberFxn( NMHDR * pNotifyStruct, LRESULT * result );
通知メッセージ ハンドラーが値を返す場合は、その値を result が指す LRESULTに格納する必要があります。
各メッセージに対して、 pNotifyStruct は NMHDR 構造体か TBNOTIFY 構造体のいずれかを指します。 これらの構造体は次のとおりです。
NMHDR 構造体には次のメンバーが含まれます。
typedef struct tagNMHDR {
HWND hwndFrom; // handle of control sending message
UINT idFrom;// identifier of control sending message
UINT code; // notification code; see below
} NMHDR;
hwndFrom
通知を送信するコントロールのウィンドウ ハンドル。 このハンドルを
CWndポインターに変換するには、 CWnd::FromHandleを使用します。idFrom
通知を送信するコントロールの識別子。
code
通知コード。 このメンバーは、 TBN_BEGINADJUST や TTN_NEEDTEXTなどのコントロールの種類に固有の値になるか、以下に示す通知に共通の値のいずれかになります。
NM_CLICK ユーザーがコントロール内でマウスの左ボタンをクリックしました。
NM_DBLCLK ユーザーがコントロール内でマウスの左ボタンをダブルクリックしました。
NM_KILLFOCUS コントロールは入力フォーカスを失いました。
NM_OUTOFMEMORY メモリ不足のために、コントロールは操作を完了できませんでした。
NM_RCLICK ユーザーがコントロール内でマウスの右ボタンをクリックしました。
NM_RDBLCLK ユーザーがコントロール内でマウスの右ボタンをダブルクリックしました。
NM_RETURN コントロールに入力フォーカスがあり、ユーザーが Enter キーを押しました。
NM_SETFOCUS コントロールは入力フォーカスを受け取りました。
TBNOTIFY 構造体には次のメンバーが含まれます。
typedef struct {
NMHDR hdr; // information common to all WM_NOTIFY messages
int iItem; // index of button associated with notification
TBBUTTON tbButton; // info about button associated withnotification
int cchText; // count of characters in button text
LPSTR lpszText;// address of button text
} TBNOTIFY, FAR* LPTBNOTIFY;
hdr
すべての WM_NOTIFY メッセージに共通の情報。
iItem
通知に関連付けられたボタンのインデックス。
tbButton
通知に関連付けられたツール バー ボタンに関する情報を格納する TBBUTTON 構造体。
cchText
ボタンのテキスト文字の数。
lpszText
ボタンのテキストへのポインター。
ツール バーが送信する通知は、次のとおりです。
TBN_BEGINADJUST
ユーザーがツール バー コントロールのカスタマイズを開始すると送信されます。 ポインターは、通知についての情報を格納する NMHDR 構造体を指します。 ハンドラーが特定の値を返す必要はありません。
TBN_BEGINDRAG
ユーザーがツール バー コントロールにあるボタンのドラッグを開始すると送信されます。 ポインターは TBNOTIFY 構造体を指します。 iItem メンバーには、ドラッグされているボタンの 0 から始まるインデックスが含まれます。 ハンドラーが特定の値を返す必要はありません。
TBN_CUSTHELP
ユーザーが [ツール バーのカスタマイズ] ダイアログ ボックスの [ヘルプ] ボタンを選ぶと送信されます。 戻り値はありません。 ポインターは、この通知メッセージについての情報を格納する NMHDR 構造体を指します。 ハンドラーが特定の値を返す必要はありません。
TBN_ENDADJUST
ユーザーがツール バー コントロールのカスタマイズを終了すると送信されます。 ポインターは、この通知メッセージについての情報を格納する NMHDR 構造体を指します。 ハンドラーが特定の値を返す必要はありません。
TBN_ENDDRAG
ユーザーがツール バー コントロールにあるボタンのドラッグを終了すると送信されます。 ポインターは TBNOTIFY 構造体を指します。 iItem メンバーには、ドラッグされているボタンの 0 から始まるインデックスが含まれます。 ハンドラーが特定の値を返す必要はありません。
TBN_GETBUTTONINFO
ユーザーがツール バー コントロールをカスタマイズしているときに送信されます。 ツール バーは、この通知メッセージを使用して [ツール バーのカスタマイズ] ダイアログ ボックスで必要になる情報を取得します。 ポインターは TBNOTIFY 構造体を指します。 iItem メンバーは、ボタンの 0 から始まるインデックスを指定します。 pszText メンバーと cchText メンバーは、現在のボタンのテキストのアドレスと長さ (文字数) で指定します。 アプリケーションでは、ボタンに関する情報をこの構造体に格納する必要があります。 ボタンの情報が構造体にコピーされた場合は TRUE を返し、それ以外の場合は FALSE を返します。
TBN_QUERYDELETE
ユーザーがツール バー コントロールをカスタマイズしているときに、ツール バー コントロールからボタンを削除できるかどうかを判断するために送信されます。 ポインターは TBNOTIFY 構造体を指します。 iItem メンバーには、削除するボタンの 0 から始まるインデックスが含まれます。 ボタンの削除を許可する場合は TRUE を返し、ボタンの削除を禁止する場合は FALSE を返します。
TBN_QUERYINSERT
ユーザーがツール バー コントロールをカスタマイズしているときに、指定したボタンの左側にボタンを挿入できるかどうかを判断するために送信されます。 ポインターは TBNOTIFY 構造体を指します。 iItem メンバーには、挿入するボタンの 0 から始まるインデックスが含まれます。 指定したボタンの前にボタンの挿入を許可する場合は TRUE を返し、ボタンの挿入を禁止する場合は FALSE を返します。
TBN_RESET
ユーザーが [ツール バーのカスタマイズ] ダイアログ ボックスの内容をリセットすると送信されます。 ポインターは、この通知メッセージについての情報を格納する NMHDR 構造体を指します。 ハンドラーが特定の値を返す必要はありません。
TBN_TOOLBARCHANGE
ユーザーがツール バー コントロールをカスタマイズした後に送信されます。 ポインターは、この通知メッセージについての情報を格納する NMHDR 構造体を指します。 ハンドラーが特定の値を返す必要はありません。