AFX 訊息

MFC 中會使用這些訊息。

訊息

下表列出 MFC 程式庫中所使用的訊息：

訊息	描述	[in] 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 物件的通知。	索引標籤的索引。	未使用。	零。
AFX_WM_CHANGE_CURRENT_FOLDER	當使用者變更目前資料夾時，架構會將此訊息傳送至 的 CMFCShellListCtrl 父系。	未使用。	未使用。	未使用。
AFX_WM_CHANGEVISUALMANAGER	當使用者變更目前的 Visual Manager 時，架構會將此訊息傳送至所有框架視窗。 為了回應此訊息，框架視窗會重新計算其區域，並視需要調整其他參數。 如果您需要收到有關此事件的通知，您可以在應用程式中處理AFX_WM_CHANGEVISUALMANAGER訊息。 您必須呼叫基類處理常式 （ OnChangeVisualManager ） 以確保架構對此事件的內部處理進行。	未使用。	未使用。	未使用。
AFX_WM_CHANGING_ACTIVE_TAB	傳送至 物件的父代 CMFCTabCtrl 。 如果您想要在使用者重設索引標籤時接收來自 CMFCTabCtrl 物件的通知，請處理此訊息。	正在啟動之索引標籤的索引。	未使用。	零。
AFX_WM_CHECKEMPTYMINIFRAME	僅限內部使用。	不適用。	不適用。	不適用。
AFX_WM_CREATETOOLBAR	當使用者 CMFCToolBarsListPropertyPage 在自訂程式期間建立新的工具列時，從 傳送。 您可以處理此訊息，以具現化自訂 CMFCToolBar 衍生的物件。 如果您處理此訊息並建立自己的工具列，請省略預設處理常式的呼叫。	未使用。	包含工具列名稱之字串的指標。	新建立工具列的指標。 Null 表示工具列建立已取消。
AFX_WM_CUSTOMIZEHELP	當使用者按下 [說明 ] 按鈕或 F1 鍵時，從自訂屬性工作表 CMFCToolbarCustomize Dialog 傳送至主框架視窗。	指定自訂屬性工作表的作用中頁面。	CMFCToolbarCustomize Dialog 物件的指標。	零個。
AFX_WM_CUSTOMIZETOOLBAR	會 CMFCToolbarCustomize Dialog 傳送此訊息，以通知父框架使用者正在建立新的工具列。	當自訂啟動時為 TRUE，當自訂完成時為 FALSE。	未使用。	零個。
AFX_WM_DELETETOOLBAR	當使用者即將在自訂模式中移除工具欄時，傳送至主框架視窗。 處理此訊息，以在使用者刪除自訂模式中的工具列時採取其他動作。 您也應該呼叫預設處理常式 （ OnToolbarDelete ），以移除工具欄。 預設處理常式會傳回值，指出是否可以移除工具欄。	未使用。	CMFCToolBar要刪除之物件的指標。	如果無法移除工具欄，則為非零;否則為 0。
AFX_WM_GETDOCUMENTCOLORS	CMFCColorMenuButton 會將此訊息傳送至主框架視窗，以擷取檔色彩。	未使用。	[in， out] CList<COLORREF, COLORREF> 物件的指標。	零個。
AFX_WM_GETDRAGBOUNDS	僅限內部使用。	不適用。	不適用。	不適用。
AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM	當使用者醒目提示功能區清單專案時，傳送至主框架視窗。	醒目提示專案的索引	的指標 CMFCBaseRibbonElement	未使用。
AFX_WM_ON_AFTER_SHELL_COMMAND	當使用者完成執行殼層命令時，傳送至 或 CMFCShellTreeCtrl 控制項的 CMFCShellListCtrl 父系。	使用者執行之命令的識別碼	未使用。	如果應用程式處理此訊息，它應該會傳回零。
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 物件的通知。	低序字會指定捲軸值，指出使用者的捲動要求。 如需詳細資訊，請參閱這個主題稍後的資料表。	未使用。	零。
AFX_WM_ON_MOVE_TAB	當使用者將索引標籤拖曳至新位置時，傳送至索引標籤視窗的父系。	索引標籤的原始位置以零起始的索引。	[out]索引標籤在其新位置中以零起始的索引。	零個。
AFX_WM_ON_MOVETABCOMPLETE	僅限內部使用。	不適用。	不適用。	不適用。
AFX_WM_ON_MOVETOTABGROUP	當使用者將 MDI 子視窗從一個索引標籤式群組移至另一個索引標籤群組時，傳送至主框架視窗。	已移除 MDI 子視窗之索引標籤視窗的控制碼 。 CMFCTabCtrl 。	[out]插入 MDI 子視窗之索引標籤視窗的控制碼 。 CMFCTabCtrl 。	忽略。
AFX_WM_ON_PRESS_CLOSE_BUTTON	當使用者按一下 控制項列標題上的 [關閉 ] 按鈕時，傳送至 的父 CDockablePane 系。	未使用。	使用者按一下 [關閉 ] 按鈕的可停駐窗格指標。	如果窗格無法關閉，則為 TRUE;否則為 FALSE。
AFX_WM_ON_RENAME_TAB	在使用者重新命名可編輯的索引標籤之後，傳送至索引標籤的父視窗。	已重新命名索引標籤之以零起始的索引。	[out]包含新索引標籤名稱之字串的指標。	如果應用程式處理此訊息，則為非零;架構會隱藏對 的 CMFCBaseTabCtrl::SetTabLabel 呼叫。 如果傳回零， CMFCBaseTabCtrl::SetTabLabel 則由架構呼叫。
AFX_WM_ON_RIBBON_CUSTOMIZE	當使用者開始自訂時傳送至父框架。 如果您想要顯示自己的自訂對話方塊，請處理此訊息。	未使用。	要自訂的功能區控制項指標。	如果應用程式處理此訊息並顯示自己的自訂對話方塊，則為非零。 如果應用程式傳回零，架構將會顯示內建自訂對話方塊。
AFX_WM_ON_TABGROUPMOUSEMOVE	僅限內部使用。	不適用。	不適用。	不適用。
AFX_WM_POSTSETPREVIEWFRAME	傳送來通知主畫面，使用者已變更預覽列印模式	TRUE 表示已設定預覽列印模式。 FALSE 表示預覽列印模式已關閉。	未使用。	未使用。
AFX_WM_PROPERTY_CHANGED	當使用者變更所選取屬性的值時，傳送給屬性方格控制項的擁有者 。 CMFCPropertyGridCtrl	屬性清單的控制項識別碼。	已變更之屬性 （ CMFCPropertyGridProperty ） 的指標。	未使用。
AFX_WM_RESETCONTEXTMENU	當使用者在自訂期間重設操作功能表時，傳送至主框架視窗。	操作功能表的資源識別碼。	目前操作功能表的指標， CMFCPopupMenu 。	未使用。
AFX_WM_RESETKEYBOARD	當使用者在自訂期間重設所有鍵盤快速鍵時，架構會將此訊息傳送至主框架視窗。	未使用。	未使用。	未使用。
AFX_WM_RESETMENU	當使用者在自訂期間重設應用程式框架功能表時，架構會將此訊息傳送給功能表擁有者（框架視窗）。	功能表資源識別碼。	未使用。	未使用。
AFX_WM_RESETPROMPT	當使用者從工具列自訂對話方塊重設工具列時，架構會傳送此訊息。 預設處理常式會顯示訊息方塊，詢問使用者是否要重設工具列。	未使用。	未使用。	未使用。
AFX_WM_RESETTOOLBAR	當 CMFCToolBar 工具列還原至其原始狀態時，物件會傳送此訊息，也就是從資源載入。 處理此訊息以重新插入類別衍生自 CMFCToolbarButton 的工具列按鈕。 如需詳細資訊，請參閱CMFCToolbarComboBoxButton。	已還原狀態之工具列的資源識別碼。	未使用。	零個。
AFX_WM_SHOWREGULARMENU	CMFCToolbarMenuButton 物件會在使用者按一下一般功能表按鈕時，將此訊息傳送給其擁有者。 當使用者按一下按鈕時，每次用來 CMFCToolbarMenuButton 顯示快顯視窗時處理此訊息。	傳送訊息之按鈕的命令識別碼。	游標的螢幕座標。 低序字會指定 x 座標。 高序字會指定 Y 座標。	未使用。
AFX_WM_TOOLBARMENU	當使用者放開滑鼠右鍵時，滑鼠指標位於窗格的用戶端或非工作區時，傳送至主框架視窗。	未使用。	滑鼠指標的螢幕座標。 低序字會指定 x 座標。 高序字會指定 Y 座標。	如果應用程式處理此訊息，則為零;否則為非零。
AFX_WM_UPDATETOOLTIPS	傳送給所有工具提示擁有者，以指出應該重新建立其工具提示控制項。	應該處理此訊息的控制項類型。 如需可能值的清單，請參閱本主題稍後的表格。	未使用。	未使用。
AFX_WM_WINDOW_HELP	CMFCWindowsManagerDialog當使用者按一下 [說明] 按鈕，或按一下 [說明 ] 標題按鈕或 F1 鍵，以進入 說明模式時，會將此訊息傳送至父框架。	未使用。	實例的 CMFCWindowsManagerDialog 指標。	未使用。

下表顯示 AFX_WM_HSCROLL 方法之 lParam 參數低字 的值：

值	意義
SB_ENDSCROLL	使用者結束捲動。
SB_LEFT	使用者捲動至左上方。
SB_RIGHT	使用者捲動至右下角。
SB_LINELEFT	使用者會向左捲動一個單位。
SB_LINERIGHT	使用者向右捲動一個單位。
SB_PAGELEFT	使用者會以視窗的寬度向左捲動。
SB_PAGERIGHT	使用者會以視窗的寬度向右捲動。
SB_THUMBPOSITION	使用者已拖曳捲動方塊 （thumb） 並放開滑鼠按鍵。 高序字表示捲動方塊在拖曳作業結尾的位置。
SB_THUMBTRACK	使用者正在拖曳捲動方塊。 AFX_WM_ON_HSCROLL訊息會重複傳送此值，直到使用者放開滑鼠按鍵為止。 高序字表示捲動方塊已拖曳的位置。

注意

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

另請參閱

宏和全域