MENUITEMINFOA 結構 (winuser.h)
包含功能表項的相關信息。
語法
typedef struct tagMENUITEMINFOA {
UINT cbSize;
UINT fMask;
UINT fType;
UINT fState;
UINT wID;
HMENU hSubMenu;
HBITMAP hbmpChecked;
HBITMAP hbmpUnchecked;
ULONG_PTR dwItemData;
LPSTR dwTypeData;
UINT cch;
HBITMAP hbmpItem;
} MENUITEMINFOA, *LPMENUITEMINFOA;
成員
cbSize
類型： UINT
結構的大小，以位元組為單位。 通話端必須將這個成員設定為 sizeof(MENUITEMINFO)。
fMask
類型： UINT
指出要擷取或設定的成員。 這個成員可以是下列一或多個值。
fType
類型： UINT
功能表項類型。 這個成員可以是下列一或多個值。
無法將MFT_BITMAP、MFT_SEPARATOR和MFT_STRING值彼此結合。 將 fMask 設定為 MIIM_TYPE 以使用 fType。
只有在 fMask 的 值為 MIIM_FTYPE 時，才會使用 fType。
| 值 | 意義 |
|---|---|
|
使用點圖顯示功能表項。 dwTypeData 成員的低序字是位圖句柄，並忽略 cch 成員。
MFT_BITMAP 會由 MIIM_BITMAP 和 hbmpItem 取代。 |
|
Places 功能表欄的新行 (功能表項) 或下拉功能表、子功能表或快捷功能表 (的新數據行 () 。 對於下拉功能表、子功能表或快捷方式功能表，垂直線會將新數據行與舊數據行分開。 |
|
Places 功能表欄的新行 (功能表項) 或下拉功能表、子功能表或快捷功能表 (的新數據行 () 。 對於下拉功能表、子功能表或快捷方式功能表，資料行不會以垂直線分隔。 |
|
將功能表項指派給擁有功能表的視窗的責任。 視窗會在第一次顯示功能表之前收到 WM_MEASUREITEM 訊息，每當必須更新功能表項的外觀時，就會收到 WM_DRAWITEM 訊息。 如果指定這個值， dwTypeData 成員會包含應用程式定義的值。 |
|
如果 hbmpChecked 成員為 NULL，則會使用單選按鈕標記來顯示選取的功能表項，而不是複選標記。 |
|
靠右對齊功能表項和任何後續專案。 只有在功能表項位於功能表欄中時，這個值才有效。 |
|
指定功能表從右至左 (預設值為由左至右) 。 這是用來支援由右至左的語言，例如阿拉伯文和希伯來文。 |
|
指定功能表項是分隔符。 功能表項分隔符會顯示為水準分隔線。 會忽略 dwTypeData 和 cch 成員。 這個值只有在下拉功能表、子功能表或快捷方式功能表中才有效。 |
|
使用文字字串顯示功能表項。 dwTypeData 成員是 Null 終止字串的指標，而 cch 成員是字串的長度。
MFT_STRING 會由 MIIM_STRING取代。 |
fState
類型： UINT
功能表項狀態。 這個成員可以是其中一或多個值。 將 fMask 設定為 MIIM_STATE 以使用 fState。
wID
類型： UINT
可識別功能表項的應用程式定義值。 將 fMask 設定為 MIIM_ID 以使用 wID。
hSubMenu
類型： HMENU
與功能表項相關聯的下拉功能表或子功能表的句柄。 如果功能表項不是開啟下拉功能表或子功能表的專案，則此成員為 NULL。 將 fMask 設定為 MIIM_SUBMENU 以使用 hSubMenu。
hbmpChecked
類型： HBITMAP
選取位圖旁要顯示的點陣圖句柄。 如果這個成員是 NULL，則會使用預設點陣圖。 如果指定 MFT_RADIOCHECK 類型值，則預設點陣圖為項目符號。 否則，它是複選標記。 將 fMask 設定為 MIIM_CHECKMARKS 以使用 hbmpChecked。
hbmpUnchecked
類型： HBITMAP
如果未選取位圖旁要顯示的點陣圖句柄。 如果此成員為 NULL，則不會使用位圖。 將 fMask 設定為 MIIM_CHECKMARKS 以使用 hbmpUnchecked。
dwItemData
類型： ULONG_PTR
與功能表項相關聯的應用程式定義值。 將 fMask 設定為 MIIM_DATA 以使用 dwItemData。
dwTypeData
類型： LPTSTR
功能表項的內容。 此成員的意義取決於 fType 的值，而且只有在 fMask 成員中設定MIIM_TYPE旗標時才使用。
若要擷取類型為 MFT_STRING 的功能表項，請先將 MENUITEMINFO 的 dwTypeData 成員設定為 NULL，然後呼叫 GetMenuItemInfo 來尋找字符串的大小。 cch+1 的值是所需的大小。 然後配置此大小的緩衝區、將指標放在 dwTypeData 中的緩衝區、遞增 cch，然後再次呼叫 GetMenuItemInfo ，以字串填滿緩衝區。 如果擷取的功能表項屬於其他類型， 則 GetMenuItemInfo 會將 dwTypeData 成員設定為 fType 成員所指定的類型值。
搭配 SetMenuItemInfo 函式使用 時，此成員應該包含 由 fType 成員指定其類型的值。
只有在 fMask 成員中設定MIIM_STRING旗標時，才會使用 dwTypeData
cch
類型： UINT
收到 MFT_STRING 類型之功能表項的相關信息時，功能表項文字的長度，以字元為單位。 不過，只有在 fMask 成員中設定MIIM_TYPE旗標且為零時，才會使用 cch。 此外，呼叫 SetMenuItemInfo 來設定功能表項的內容時，會忽略 cch。
請注意，在呼叫 GetMenuItemInfo 之前，應用程式必須將 cch 設定為 dwTypeData 成員指向的緩衝區長度。 如果擷取的功能表項的類型 為 MFT_STRING (，如 fType 成員所指出) ， 則 GetMenuItemInfo 會將 cch 變更為功能表項文字的長度。 如果擷取的功能表項屬於其他類型， GetMenuItemInfo 會將 cch 字段設定為零。
在 fMask 成員中設定MIIM_STRING旗標時，會使用 cch 成員。
hbmpItem
類型： HBITMAP
要顯示之位圖的句柄，或者它可以是下表中的其中一個值。 當 fMask 成員中設定MIIM_BITMAP旗標時，就會使用它。
| 值 | 意義 |
|---|---|
|
由擁有功能表之視窗繪製的點陣圖。 應用程式必須處理 WM_MEASUREITEM 和 WM_DRAWITEM 訊息。 |
|
選單列的 [關閉] 按鈕。 |
|
功能表列的 [已停用關閉] 按鈕。 |
|
功能表欄的 [最小化] 按鈕。 |
|
已停用功能表欄的最小化按鈕。 |
|
功能表列的 [還原] 按鈕。 |
|
子選單的 [關閉] 按鈕。 |
|
子選單的 [最大化] 按鈕。 |
|
子功能表的 [最小化] 按鈕。 |
|
子功能表的 [還原] 按鈕。 |
|
Windows 圖示或 dwItemData 中所指定視窗的圖示。 |
備註
MENUITEMINFO 結構會與 GetMenuItemInfo、InsertMenuItem 和 SetMenuItemInfo 函式搭配使用。
功能表可以使用文字、點陣圖或兩者來顯示專案。
注意
winuser.h 標頭會將 MENUITEMINFO 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 標頭 | winuser.h (包含 Windows.h) |
另請參閱
概念
參考
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應