共用方式為

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

另請參閱

巨集和全域