ModifyMenuW 函式 (winuser.h)
變更現有的功能表項目。 此函式可用來指定功能表項目的內容、外觀和行為。
語法
BOOL ModifyMenuW(
[in] HMENU hMnu,
[in] UINT uPosition,
[in] UINT uFlags,
[in] UINT_PTR uIDNewItem,
[in, optional] LPCWSTR lpNewItem
);
參數
[in] hMnu
類型： HMENU
要變更之功能表的控制碼。
[in] uPosition
類型： UINT
要變更的功能表項目，由 uFlags 參數決定。
[in] uFlags
類型： UINT
控制 uPosition 參數的解譯，以及功能表項目的內容、外觀和行為。 此參數必須包含下列其中一個必要值。
| 值 | 意義 |
|---|---|
|
表示 uPosition 參數會提供功能表項目的識別碼。 如果未指定MF_BYCOMMAND或MF_BYPOSITION旗標，則MF_BYCOMMAND旗標是預設值。 |
|
表示 uPosition 參數會提供功能表項目以零起始的相對位置。 |
參數也必須至少包含下列其中一個值。
| 值 | 意義 |
|---|---|
|
使用點陣圖做為功能表項目。 lpNewItem參數包含點陣圖的控制碼。 |
|
將核取記號放在專案旁邊。 如果您的應用程式提供核取記號點陣圖 (請參閱 SetMenuItemBitmaps 函式) ，此旗標會顯示功能表項目旁的選取點陣圖。 |
|
停用功能表項目，使其無法選取，但此旗標不會呈現灰色。 |
|
啟用功能表項目，以便選取功能表項目，並從其灰色狀態還原它。 |
|
停用功能表項目並呈現灰色，使其無法選取。 |
|
函式與功能表列 的MF_MENUBREAK 旗標相同。 對於下拉式功能表、子功能表或快捷方式功能表，新資料行會以垂直線分隔舊資料行。 |
|
將專案放在功能表列的新行 () ，或在下拉式功能表、子功能表或快捷) 功能表 (的新資料行 (中，而不分隔資料行。 |
|
指定專案是擁有者繪製的專案。 第一次顯示功能表之前，擁有功能表的視窗會收到 WM_MEASUREITEM 訊息，以擷取功能表項目的寬度和高度。 每當必須更新功能表項目的外觀時， 就會將WM_DRAWITEM 訊息傳送至擁有者視窗的視窗程式。 |
|
指定功能表項目會開啟下拉式功能表或子功能表。 uIDNewItem參數會指定下拉式功能表或子功能表的控制碼。 此旗標可用來將功能表名稱新增至功能表列，或開啟子功能表至下拉式功能表、子功能表或快捷方式功能表的功能表項目。 |
|
繪製水準分隔線。 此旗標僅用於下拉式功能表、子功能表或快捷方式功能表。 線條無法呈現灰色、停用或反白顯示。 忽略 lpNewItem和uIDNewItem參數。 |
|
指定功能表項目是文字字串; lpNewItem 參數是字串的指標。 |
|
不會在專案旁放置核取記號， (預設) 。 如果您的應用程式提供核取記號點陣圖 (請參閱 SetMenuItemBitmaps 函式) ，此旗標會顯示功能表項目旁的清除點陣圖。 |
[in] uIDNewItem
類型： UINT_PTR
已修改功能表項目的識別碼，或者，如果 uFlags 參數已設定 MF_POPUP 旗標，則為下拉式功能表或子功能表的控制碼。
[in, optional] lpNewItem
類型： LPCTSTR
已變更功能表項目的內容。 此參數的解譯取決於 uFlags 參數是否包含 MF_BITMAP、 MF_OWNERDRAW或 MF_STRING 旗標。
| 值 | 意義 |
|---|---|
|
點陣圖控制碼。 |
|
應用程式所提供的值，用來維護與功能表項目相關的其他資料。 此值位於建立功能表項目或更新功能表項目時，由WM_MEASUREITEM或WM_DRAWITEM訊息的lParam參數所指向之結構的itemData成員中。 |
|
null 終止字串的指標 (預設) 。 |
傳回值
類型： BOOL
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
如果 ModifyMenu 取代開啟下拉式功能表或子功能表的功能表項目，函式會終結舊的下拉式功能表或子功能表，並釋放它所使用的記憶體。
為了讓鍵盤快速鍵使用點陣圖或擁有者繪製功能表項目，功能表的擁有者必須處理 WM_MENUCHAR 訊息。 如需詳細資訊 ，請參閱擁有者繪製的功能表和WM_MENUCHAR訊息 。
每當功能表變更時，應用程式都必須呼叫 DrawMenuBar 函式，無論功能表是否在顯示的視窗中。 若要變更現有功能表項目的屬性，使用 CheckMenuItem 和 EnableMenuItem 函式會更快。
下列旗標群組無法一起使用：
- MF_BYCOMMAND 和 MF_BYPOSITION
- MF_DISABLED、 MF_ENABLED和 MF_GRAYED
- MF_BITMAP、 MF_STRING、 MF_OWNERDRAW和 MF_SEPARATOR
- MF_MENUBARBREAK 和 MF_MENUBREAK
- MF_CHECKED 和 MF_UNCHECKED
範例
如需範例，請參閱 設定Menu-Item文字字串的字型。
注意
winuser.h 標頭會將 ModifyMenu 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平臺 | Windows |
| 標頭 | winuser.h (包含 Windows.h) |
| 程式庫 | User32.lib |
| DLL | User32.dll |
| API 集合 | ext-ms-win-ntuser-menu-l1-1-3 (Windows 10 10.0.14393 版) |
另請參閱
概念
參考