AFX 的郵件
這些訊息會使用 MFC。
訊息
下表列出用於 MFC 程式庫的訊息:
訊息 |
描述 |
[in] wParam |
lParam (所有參數為 [除非另有說明)。 |
傳回值 |
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 |
當使用者變更目前視覺化管理員時，架構會傳送訊息給所有框架視窗。 以回應這個訊息，框架視窗重新計算其區域並調整其他參數 (需要的話)。 如果需要，您會收到有關這個事件，您可以管理應用程式的 AFX_WM_CHANGEVISUALMANAGER 訊息。 您必須呼叫基底類別處理常式 (OnChangeVisualManager) 保證框架的內部處理這個事件發生。 |
不適用。 |
不適用。 |
不適用。 |
AFX_WM_CHANGING_ACTIVE_TAB |
傳送至 CMFCTabCtrl 物件的父代。 請處理這個訊息，如果您要從 CMFCTabCtrl 物件接收的通知，當使用者重設選項時。 |
起始選項的索引。 |
不適用。 |
非零。 |
AFX_WM_CHECKEMPTYMINIFRAME |
僅供內部使用。 |
不適用。 |
不適用。 |
不適用。 |
AFX_WM_CREATETOOLBAR |
由 CMFCToolBarsListPropertyPage ，當使用者在自訂流程中建立新的工具列。 您可以處理這個訊息具現化自訂 CMFCToolBar 衍生的物件。 如果您處理這個訊息和建立自己的工具列，請省略所有的預設處理常式。 |
不適用。 |
out 包含工具列名稱之字串的指標。 |
out 新建立之工具列的指標。 Null 表示工具列建立已取消。 |
AFX_WM_CUSTOMIZEHELP |
傳送到從自訂屬性工作表 CMFCToolbarCustomizeDialog 的主框架視窗，當使用者按下 [說明] 按鈕或 F1 鍵。 |
指定自訂屬性工作表的使用中的頁面。 |
CMFCToolbarCustomize的Dialog 物件的指標。 |
零 |
AFX_WM_CUSTOMIZETOOLBAR |
CMFCToolbarCustomizeDialog 傳送此訊息告知父框架使用者建立新的工具列。 |
TRUE ，表示自訂啟動，則為 FALSE ，當自訂完成。 |
不適用。 |
零 |
AFX_WM_DELETETOOLBAR |
傳送到主框架視窗，當使用者將刪除一個工具列自訂模式。 當使用者在自訂模式時，刪除一個工具列中處理這個訊息採取其他動作。 您也應該呼叫預設處理常式 (OnToolbarDelete)，刪除工具列。 預設處理常式傳回值表示刪除工具列是否可能的。 |
不適用。 |
in 要刪除之 CMFCToolBar 物件的指標。 |
非零，如果工具列無法刪除;否則為 0。 |
AFX_WM_GETDOCUMENTCOLORS |
CMFCColorMenuButton 會傳送訊息至主框架視窗擷取文件色彩。 |
不適用。 |
[，] 對 CList<COLORREF, COLORREF> 物件的指標。 |
零 |
AFX_WM_GETDRAGBOUNDS |
僅供內部使用。 |
不適用。 |
不適用。 |
不適用。 |
AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM |
傳送到主框架視窗，當使用者反白顯示功能區清單項目。 |
反白顯示的項目索引。 |
out CMFCBaseRibbonElement的指標。 |
不適用。 |
AFX_WM_ON_AFTER_SHELL_COMMAND |
傳送到 CMFCShellListCtrl 或 CMFCShellTreeCtrl 父控制項，當使用者完成執行 Shell 命令。 |
使用者執行命令的 ID。 |
不適用。 |
如果應用程式處理序這個訊息，它應該傳回零。 |
AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU |
其會顯示快顯功能表之前，架構會傳送訊息至功能區的父代。 您可以處理這個訊息和隨時修改快顯功能表。 |
不適用。 |
out 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 |
傳送到主框架視窗選項時，視窗會顯示索引標籤的工具提示，則為，如果自訂工具提示已啟用。 |
不適用。 |
in CMFCTabToolTipInfo 結構的指標。 |
不適用。 |
AFX_WM_ON_HSCROLL |
傳送至可調整大小控制項的控制項。 當 Scroll 事件在索引標籤式裝飾水平捲軸時發生，請處理這個訊息會從 CMFCTabCtrl 物件的通知。 |
低序位文字表示指定使用者的捲動要求的捲軸值。 如需詳細資訊，請參閱稍後要在這個主題。 |
不適用。 |
非零。 |
AFX_WM_ON_MOVE_TAB |
傳送至索引標籤式視窗的父代，則當使用者拖曳選項至新位置。 |
選取項目之以零起始的索引在它的原始位置。 |
[out] 選項之以零起始的索引其新位置的。 |
零 |
AFX_WM_ON_MOVETABCOMPLETE |
僅供內部使用。 |
不適用。 |
不適用。 |
不適用。 |
AFX_WM_ON_MOVETOTABGROUP |
傳送到主框架視窗，當使用者從一個群組移動 MDI 子視窗至另一個。 |
的控制代碼 (CMFCTabCtrl) MDI 子視窗中移除的索引標籤式視窗。 |
[out] 控制代碼 (CMFCTabCtrl) MDI 子視窗插入了的索引標籤式視窗。 |
已忽略。 |
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) 的擁有者，當使用者變更選取的屬性值。 |
屬性清單的控制項 ID。 |
要轉換的屬性 (CMFCPropertyGridProperty) 的指標。 |
不適用。 |
AFX_WM_RESETCONTEXTMENU |
傳送到主框架視窗，當使用者在自訂中重設內容功能表。 |
內容功能表的資源 ID。 |
對目前內容功能表， CMFCPopupMenu的指標。 |
不適用。 |
AFX_WM_RESETKEYBOARD |
當使用者在自訂時，會將所有的鍵盤快速鍵架構會傳送訊息至主框架視窗。 |
不適用。 |
不適用。 |
不適用。 |
AFX_WM_RESETMENU |
架構會傳送訊息給功能表擁有人 (Frame Window)，當使用者在自訂時重設應用程式架構功能表 |
功能表資源 ID. |
不適用。 |
不適用。 |
AFX_WM_RESETPROMPT |
當使用者將從工具列自訂對話方塊時，的工具列架構傳送這個資訊。 預設處理常式會顯示訊息詢問方塊使用者要重設工具列。 |
不適用。 |
不適用。 |
不適用。 |
AFX_WM_RESETTOOLBAR |
當工具列還原為其原始狀態，也就是說，載入資源中， CMFCToolBar 物件傳送這個資訊。 處理這個訊息再插入類別衍生自 CMFCToolbarButton的工具列按鈕。 如需詳細資訊，請參閱CMFCToolbarComboBoxButton。 |
狀態還原工具列的資源 ID。 |
不適用。 |
零 |
AFX_WM_SHOWREGULARMENU |
當使用者按一下一般功能表按鈕時，CMFCToolbarMenuButton 物件會傳送訊息給它的擁有人。 每次處理這個訊息您使用 CMFCToolbarMenuButton 顯示快顯功能表，當使用者按一下按鈕時。 |
傳送訊息之按鈕的命令 ID。 |
資料指標的螢幕座標。 低序位文字指定 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 資訊重複傳送與此值，直到使用者放開滑鼠按鈕。 高序位文字表示捲動方塊將拖曳的位置。 |
.gif "注意事項") 注意事項 |
|---|
如果低序位文字是 SB_THUMBPOSITION 或 SB_THUMBTRACK， lParam 參數的高序位文字指定捲動方塊的目前位置;否則，不會使用此文字。 |
下表列出 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 |