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取代。 |
|
將功能表項目放在功能表列的新行 () 或下拉式功能表、子功能表或快顯功能表) 的新資料行 (中。 對於下拉式功能表、子功能表或快捷方式功能表，垂直線會將新資料行與舊資料行分開。 |
|
將功能表項目放在功能表列的新行 () 或下拉式功能表、子功能表或快顯功能表) 的新資料行 (中。 對於下拉式功能表、子功能表或快捷方式功能表，資料行不會以垂直線分隔。 |
|
指派將功能表項目繪製至擁有功能表的視窗的責任。 視窗會在第一次顯示功能表之前收到 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 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | winuser.h (包括 Windows.h) |
另請參閱
概念
參考