AFX メッセージ
これらのメッセージは MFC で使用されます。
メッセージ
次の表に、MFC ライブラリで使用されるメッセージを示します。
| メッセージ | 説明 | [入力] wParam | lParam (特に明記されていない限り、すべてのパラメーターは [in] です)。 | 戻り値 |
|---|---|---|---|---|
| AFX_WM_ACCGETOBJECT | 使用しません。 | 使用しません。 | 該当なし。 | 該当なし。 |
| AFX_WM_ACCGETSTATE | アクセシビリティのサポートに使用されます。 このメッセージを CMFCPopupMenu または CMFCRibbonPanelMenu に送信して、現在の要素の状態を取得します。 |
要素のインデックス。メニュー ボタンまたは区切り記号を指定できます。 | 未使用。 | 要素の状態。 インデックスが無効な場合は -1、メニュー ボタンに特別な属性がない場合は 0 です。 それ以外の場合は、次のフラグの組み合わせになります。 TBBS_DISABLED — アイテムが無効です TBBS_CHECKED — 項目がオンになっている TBBS_BUTTON — 品目は標準押ボタンです TBBS_PRESSED — ボタンが押されている TBBS_INDETERMINATE — 未定義の状態 TBBS_SEPARATOR - メニュー ボタンではなく、この要素は他のメニュー項目間の分離を形成します |
| AFX_WM_CHANGE_ACTIVE_TAB | フレームワークは、このメッセージをサイズ変更可能なコントロール バー コントロールに送信します。 このメッセージを処理して、ユーザーがアクティブなタブを変更したときに CMFCTabCtrl オブジェクトから通知を受信します。 |
タブのインデックス。 | 未使用。 | 0 以外。 |
| AFX_WM_CHANGE_CURRENT_FOLDER | フレームワークは、ユーザーが現在のフォルダーを変更したときに、 CMFCShellListCtrl の親にこのメッセージを送信します。 |
使用しません。 | 使用しません。 | 使用しません。 |
| AFX_WM_CHANGEVISUALMANAGER | フレームワークは、ユーザーが現在の Visual Manager を変更すると、このメッセージをすべてのフレーム ウィンドウに送信します。 このメッセージに応答して、フレーム ウィンドウはその領域を再計算し、必要に応じて他のパラメーターを調整します。 このイベントに関する通知を受け取る必要がある場合は、アプリケーションでAFX_WM_CHANGEVISUALMANAGERメッセージを処理できます。 このイベントのフレームワークの内部処理が確実に行われるように、基底クラス ハンドラー (OnChangeVisualManager) を呼び出す必要があります。 |
使用しません。 | 使用しません。 | 使用しません。 |
| AFX_WM_CHANGING_ACTIVE_TAB | CMFCTabCtrl オブジェクトの親に送信されます。 ユーザーがタブをリセットしたときに CMFCTabCtrl オブジェクトから通知を受信する場合は、このメッセージを処理します。 |
アクティブ化されているタブのインデックス。 | 未使用。 | 0 以外。 |
| AFX_WM_CHECKEMPTYMINIFRAME | 内部使用のみ。 | 該当なし。 | 該当なし。 | 該当なし。 |
| AFX_WM_CREATETOOLBAR | ユーザーがカスタマイズ プロセス中に新しいツール バーを作成したときに、 CMFCToolBarsListPropertyPage から送信されます。 このメッセージを処理して、カスタム CMFCToolBar 派生オブジェクトをインスタンス化できます。 このメッセージを処理し、独自のツール バーを作成する場合は、既定のハンドラーの呼び出しを省略します。 |
未使用。 | ツール バーの名前を含む文字列へのポインター。 | 新しく作成されたツール バーへのポインター。 NULL は、ツール バーの作成が取り消されたことを示します。 |
| AFX_WM_CUSTOMIZEHELP | ユーザーが Help ボタンまたは F1 キーを押したときにCMFCToolbarCustomize Dialogカスタマイズ プロパティ シートからメイン フレーム ウィンドウに送信されます。 |
カスタマイズ プロパティ シートのアクティブなページを指定します。 | CMFCToolbarCustomize Dialog オブジェクトを指すポインターです。 |
ゼロ。 |
| AFX_WM_CUSTOMIZETOOLBAR | CMFCToolbarCustomize Dialogは、このメッセージを送信して、ユーザーが新しいツール バーを作成していることを親フレームに通知します。 |
カスタマイズが開始されると TRUE、カスタマイズが完了すると FALSE。 | 未使用。 | ゼロ。 |
| AFX_WM_DELETETOOLBAR | ユーザーがカスタマイズ モードでツール バーを削除しようとしているときに、メイン フレーム ウィンドウに送信されます。 ユーザーがカスタマイズ モードでツール バーを削除したときに追加のアクションを実行するには、このメッセージを処理します。 ツール バーを削除する既定のハンドラー ( OnToolbarDelete) も呼び出す必要があります。 既定のハンドラーは、ツール バーを削除できるかどうかを示す値を返します。 |
未使用。 | 削除する CMFCToolBar オブジェクトへのポインター。 |
ツールバーを削除できない場合は 0 以外。それ以外の場合は 0。 |
| AFX_WM_GETDOCUMENTCOLORS | CMFCColorMenuButton は、このメッセージをメイン フレーム ウィンドウに送信して、ドキュメントの色を取得します。 |
未使用。 | [入力、出力] CList<COLORREF, COLORREF> オブジェクトへのポインター。 |
ゼロ。 |
| AFX_WM_GETDRAGBOUNDS | 内部使用のみ。 | 該当なし。 | 該当なし。 | 該当なし。 |
| AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM | ユーザーがリボン リスト アイテムを強調表示したときにメイン フレーム ウィンドウに送信されます。 | 強調表示されている項目のインデックス | へのポインター CMFCBaseRibbonElement |
未使用。 |
| AFX_WM_ON_AFTER_SHELL_COMMAND | ユーザーがシェル コマンドの実行を完了したときに、 CMFCShellListCtrl コントロールまたは CMFCShellTreeCtrl コントロールの親に送信されます。 |
ユーザーが実行したコマンドの ID | 未使用。 | アプリケーションがこのメッセージを処理する場合は、0 を返す必要があります。 |
| AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU | フレームワークは、ポップアップ メニューを表示する前に、リボンの親にこのメッセージを送信します。 このメッセージは、いつでも処理したり、ポップアップ メニューを変更したりできます。 | 未使用。 | へのポインター CMFCBaseRibbonElement |
未使用。 |
| AFX_WM_ON_CANCELTABMOVE | 内部使用のみ。 | 該当なし。 | 該当なし。 | |
| AFX_WM_ON_CHANGE_RIBBON_CATEGORY | フレームワークは、ユーザーがアクティブなリボン コントロール カテゴリを変更すると、このメッセージをメイン フレームに送信します。 | 未使用。 | カテゴリが変更された CMFCRibbonBar へのポインター。 |
未使用。 |
| AFX_WM_ON_CLOSEPOPUPWINDOW | フレームワークは、ウィンドウが閉じようとしていることを CMFCDesktopAlertWnd の所有者に通知するために、このメッセージを送信します。 |
未使用。 | CMFCDesktopAlertWnd オブジェクトへのポインター。 |
未使用。 |
| AFX_WM_ON_DRAGCOMPLETE | 内部使用のみ。 | 該当なし。 | 該当なし。 | 該当なし。 |
| AFX_WM_ON_GET_TAB_TOOLTIP | カスタム ヒントが有効になっている場合、タブ ウィンドウがタブのヒントを表示しようとしているときにメイン フレーム ウィンドウに送信されます。 | 未使用。 | CMFCTabToolTipInfo 構造体へのポインター。 |
未使用。 |
| AFX_WM_ON_HSCROLL | サイズ変更可能なコントロール バー コントロールに送信されます。 このメッセージを処理して、タブ付きウィジェットの水平スクロール バーでスクロール イベントが発生したときに、 CMFCTabCtrl オブジェクトから通知を受信します。 |
下位ワードは、ユーザーのスクロール要求を示すスクロール バー値を指定します。 詳細については、このトピックで後に示す表を参照してください。 | 未使用。 | 0 以外。 |
| AFX_WM_ON_MOVE_TAB | ユーザーがタブを新しい位置にドラッグしたときに、タブ付きウィンドウの親に送信されます。 | 元の位置にあるタブの 0 から始まるインデックス。 | [out]新しい位置にあるタブの 0 から始まるインデックス。 | ゼロ。 |
| AFX_WM_ON_MOVETABCOMPLETE | 内部使用のみ。 | 該当なし。 | 該当なし。 | 該当なし。 |
| AFX_WM_ON_MOVETOTABGROUP | ユーザーがタブ付きグループ間で MDI 子ウィンドウを移動すると、メイン フレーム ウィンドウに送信されます。 | MDI 子ウィンドウが削除されたタブ付きウィンドウ (CMFCTabCtrl) へのハンドル。 |
[out]MDI 子ウィンドウが挿入されたタブ付きウィンドウ (CMFCTabCtrl) へのハンドル。 |
無視されます。 |
| AFX_WM_ON_PRESS_CLOSE_BUTTON | ユーザーがコントロール バーのキャプションの Close ボタンをクリックすると、CDockablePaneの親に送信されます。 |
未使用。 | ユーザーが Close ボタンをクリックしたドッキング可能なウィンドウへのポインター。 | ウィンドウを閉じることができない場合は TRUE。それ以外の場合は FALSE。 |
| AFX_WM_ON_RENAME_TAB | ユーザーが編集可能なタブの名前を変更した後、タブ付きウィンドウの親に送信されます。 | 名前が変更されたタブの 0 から始まるインデックス。 | [out]新しいタブ名を含む文字列へのポインター。 | アプリケーションがこのメッセージを処理する場合は 0 以外。フレームワークは、 CMFCBaseTabCtrl::SetTabLabelの呼び出しを抑制します。 0 が返された場合、 CMFCBaseTabCtrl::SetTabLabel はフレームワークによって呼び出されます。 |
| AFX_WM_ON_RIBBON_CUSTOMIZE | ユーザーがカスタマイズを開始すると、親フレームに送信されます。 独自のカスタマイズ ダイアログ ボックスを表示する場合は、このメッセージを処理します。 | 未使用。 | カスタマイズするリボン コントロールへのポインター。 | アプリケーションがこのメッセージを処理し、独自のカスタマイズ ダイアログ ボックスを表示する場合は 0 以外。 アプリケーションから 0 が返された場合、フレームワークには組み込みのカスタマイズ ダイアログ ボックスが表示されます。 |
| AFX_WM_ON_TABGROUPMOUSEMOVE | 内部使用のみ。 | 該当なし。 | 該当なし。 | 該当なし。 |
| AFX_WM_POSTSETPREVIEWFRAME | ユーザーが印刷プレビュー モードを変更したことをメイン フレームに通知するために送信されます | TRUE は、印刷プレビュー モードが設定されていることを示します。 FALSE は、印刷プレビュー モードがオフになっていることを示します。 | 使用しません。 | 使用しません。 |
| AFX_WM_PROPERTY_CHANGED | ユーザーが選択したプロパティの値を変更したときに、プロパティ グリッド コントロール (CMFCPropertyGridCtrl) の所有者に送信されます。 |
プロパティ リストのコントロール ID。 | 変更されたプロパティ (CMFCPropertyGridProperty) へのポインター。 |
未使用。 |
| AFX_WM_RESETCONTEXTMENU | ユーザーがカスタマイズ中にコンテキスト メニューをリセットすると、メイン フレーム ウィンドウに送信されます。 | コンテキスト メニューのリソース ID。 | 現在のコンテキスト メニューへのポインター。 CMFCPopupMenu。 |
未使用。 |
| AFX_WM_RESETKEYBOARD | フレームワークは、ユーザーがカスタマイズ中にすべてのキーボード アクセラレータをリセットすると、このメッセージをメイン フレーム ウィンドウに送信します。 | 使用しません。 | 使用しません。 | 使用しません。 |
| AFX_WM_RESETMENU | フレームワークは、ユーザーがカスタマイズ中にアプリケーション フレーム メニューをリセットしたときに、メニュー所有者 (フレーム ウィンドウ) にこのメッセージを送信します | メニュー リソース ID。 | 使用しません。 | 使用しません。 |
| AFX_WM_RESETPROMPT | フレームワークは、ユーザーがツール バーのカスタマイズ ダイアログ ボックスからツール バーをリセットすると、このメッセージを送信します。 既定のハンドラーは、ユーザーがツール バーをリセットするかどうかを確認するメッセージ ボックスを表示します。 | 使用しません。 | 使用しません。 | 使用しません。 |
| AFX_WM_RESETTOOLBAR | CMFCToolBar オブジェクトは、ツール バーが元の状態 (つまりリソースから読み込まれた状態) に復元されたときに、このメッセージを送信します。 クラスが CMFCToolbarButtonから派生したツール バー ボタンを再挿入するには、このメッセージを処理します。 詳細については、CMFCToolbarComboBoxButtonを参照してください。 |
状態が復元されたツール バーのリソース ID。 | 未使用。 | ゼロ。 |
| AFX_WM_SHOWREGULARMENU | CMFCToolbarMenuButton オブジェクトは、ユーザーが通常のメニュー ボタンをクリックすると、その所有者にこのメッセージを送信します。 CMFCToolbarMenuButtonを使用して、ユーザーがボタンをクリックしたときにポップアップ メニューを表示するたびに、このメッセージを処理します。 |
メッセージを送信するボタンのコマンド ID。 | カーソルの画面座標。 下位ワードは x 座標を指定します。 上位ワードは y 座標を指定します。 | 未使用。 |
| AFX_WM_TOOLBARMENU | マウス ポインターがウィンドウのクライアント領域またはクライアント以外の領域にあるときに、ユーザーがマウスの右ボタンを離すと、メイン フレーム ウィンドウに送信されます。 | 未使用。 | マウス ポインターの画面座標。 下位ワードは x 座標を指定します。 上位ワードは y 座標を指定します。 | アプリケーションがこのメッセージを処理する場合は 0。それ以外の場合は 0 以外。 |
| AFX_WM_UPDATETOOLTIPS | ツールヒント コントロールを再作成する必要があることを示すために、すべてのツールヒントの所有者に送信されます。 | このメッセージを処理するコントロールの種類。 使用可能な値の一覧については、このトピックの後半の表を参照してください。 | 使用しません。 | 使用しません。 |
| AFX_WM_WINDOW_HELP | CMFCWindowsManagerDialog は、ユーザーが Help ボタンをクリックしたとき、または Help キャプション ボタンまたは F1 キーをクリックしてヘルプ モードに入ったときに、このメッセージを親フレームに送信します。 |
未使用。 | CMFCWindowsManagerDialogのインスタンスへのポインター。 |
未使用。 |
次の表に、AFX_WM_HSCROLL メソッドの lParam パラメーターの下位ワードの値を示します。
| 値 | 意味 |
|---|---|
| SB_ENDSCROLL | ユーザーはスクロールを終了します。 |
| SB_LEFT | ユーザーは左上にスクロールします。 |
| SB_RIGHT | ユーザーは右下にスクロールします。 |
| SB_LINELEFT | ユーザーは 1 単位ずつ左にスクロールします。 |
| SB_LINERIGHT | ユーザーは 1 単位右にスクロールします。 |
| SB_PAGELEFT | ユーザーはウィンドウの幅を左にスクロールします。 |
| SB_PAGERIGHT | ユーザーはウィンドウの幅を右にスクロールします。 |
| SB_THUMBPOSITION | ユーザーがスクロール ボックス (つまみ) をドラッグし、マウス ボタンを離しました。 高位ワードは、ドラッグ操作の最後のスクロール ボックスの位置を示します。 |
| SB_THUMBTRACK | ユーザーがスクロール ボックスをドラッグしています。 AFX_WM_ON_HSCROLL メッセージは、ユーザーがマウス ボタンを離すまで、この値で繰り返し送信されます。 高位ワードは、スクロール ボックスがドラッグされた位置を示します。 |
Note
lParam パラメーターの上位ワードは、下位ワードがSB_THUMBPOSITIONまたはSB_THUMBTRACKの場合にスクロール ボックスの現在位置を指定します。それ以外の場合、この単語は使用されません。
次の表に、AFX_WM_UPDATETOOLTIPS メッセージの lParam パラメーターのフラグ値を示します。
| フラグ | 値 |
|---|---|
| AFX_TOOLTIP_TYPE_DEFAULT | 0x0001 |
| AFX_TOOLTIP_TYPE_TOOLBAR | 0x0002 |
| AFX_TOOLTIP_TYPE_TAB | 0x0004 |
| AFX_TOOLTIP_TYPE_MINIFRAME | 0x0008 |
| AFX_TOOLTIP_TYPE_DOCKBAR | 0x0010 |
| AFX_TOOLTIP_TYPE_EDIT | 0x0020 |
| AFX_TOOLTIP_TYPE_BUTTON | 0x0040 |
| AFX_TOOLTIP_TYPE_TOOLBOX | 0x0080 |
| AFX_TOOLTIP_TYPE_ALL | 0xFFFF |