共用方式為


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

指出要擷取或設定的成員。 這個成員可以是下列一或多個值。

意義
MIIM_BITMAP
0x00000080
擷取或設定 hbmpItem 成員。
MIIM_CHECKMARKS
0x00000008
擷取或設定 hbmpCheckedhbmpUnchecked 成員。
MIIM_DATA
0x00000020
擷取或設定 dwItemData 成員。
MIIM_FTYPE
0x00000100
擷取或設定 fType 成員。
MIIM_ID
0x00000002
擷取或設定 wID 成員。
MIIM_STATE
0x00000001
擷取或設定 fState 成員。
MIIM_STRING
0x00000040
擷取或設定 dwTypeData 成員。
MIIM_SUBMENU
0x00000004
擷取或設定 hSubMenu 成員。
MIIM_TYPE
0x00000010
擷取或設定 fTypedwTypeData 成員。

MIIM_TYPE 會取代為 MIIM_BITMAPMIIM_FTYPEMIIM_STRING

fType

類型: UINT

功能表項類型。 這個成員可以是下列一或多個值。

無法將MFT_BITMAPMFT_SEPARATORMFT_STRING值彼此結合。 將 fMask 設定為 MIIM_TYPE 以使用 fType

只有在 fMask 的 值為 MIIM_FTYPE 時,才會使用 fType

意義
MFT_BITMAP
0x00000004L
使用點圖顯示功能表項。 dwTypeData 成員的低序字是位圖句柄,並忽略 cch 成員。

MFT_BITMAP 會由 MIIM_BITMAPhbmpItem 取代。

MFT_MENUBARBREAK
0x00000020L
Places 功能表欄的新行 (功能表項) 或下拉功能表、子功能表或快捷功能表 (的新數據行 () 。 對於下拉功能表、子功能表或快捷方式功能表,垂直線會將新數據行與舊數據行分開。
MFT_MENUBREAK
0x00000040L
Places 功能表欄的新行 (功能表項) 或下拉功能表、子功能表或快捷功能表 (的新數據行 () 。 對於下拉功能表、子功能表或快捷方式功能表,資料行不會以垂直線分隔。
MFT_OWNERDRAW
0x00000100L
將功能表項指派給擁有功能表的視窗的責任。 視窗會在第一次顯示功能表之前收到 WM_MEASUREITEM 訊息,每當必須更新功能表項的外觀時,就會收到 WM_DRAWITEM 訊息。 如果指定這個值, dwTypeData 成員會包含應用程式定義的值。
MFT_RADIOCHECK
0x00000200L
如果 hbmpChecked 成員為 NULL,則會使用單選按鈕標記來顯示選取的功能表項,而不是複選標記。
MFT_RIGHTJUSTIFY
0x00004000L
靠右對齊功能表項和任何後續專案。 只有在功能表項位於功能表欄中時,這個值才有效。
MFT_RIGHTORDER
0x00002000L
指定功能表從右至左 (預設值為由左至右) 。 這是用來支援由右至左的語言,例如阿拉伯文和希伯來文。
MFT_SEPARATOR
0x00000800L
指定功能表項是分隔符。 功能表項分隔符會顯示為水準分隔線。 會忽略 dwTypeDatacch 成員。 這個值只有在下拉功能表、子功能表或快捷方式功能表中才有效。
MFT_STRING
0x00000000L
使用文字字串顯示功能表項。 dwTypeData 成員是 Null 終止字串的指標,而 cch 成員是字串的長度。

MFT_STRING 會由 MIIM_STRING取代。

fState

類型: UINT

功能表項狀態。 這個成員可以是其中一或多個值。 將 fMask 設定為 MIIM_STATE 以使用 fState

意義
MFS_CHECKED
0x00000008L
檢查功能表項。 如需所選功能表項的詳細資訊,請參閱 hbmpChecked 成員。
MFS_DEFAULT
0x00001000L
指定功能表項是預設值。 功能表只能包含一個預設功能表項,以粗體顯示。
MFS_DISABLED
0x00000003L
停用功能表項並呈現灰色,使其無法選取。 這相當於 MFS_GRAYED
MFS_ENABLED
0x00000000L
啟用功能表項,以便選取它。 這是預設狀態。
MFS_GRAYED
0x00000003L
停用功能表項並呈現灰色,使其無法選取。 這相當於 MFS_DISABLED
MFS_HILITE
0x00000080L
醒目提示功能表項。
MFS_UNCHECKED
0x00000000L
取消核取功能表項。 如需清除功能表項的詳細資訊,請參閱 hbmpChecked 成員。
MFS_UNHILITE
0x00000000L
從功能表項移除醒目提示。 這是預設狀態。

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 的功能表項,請先將 MENUITEMINFOdwTypeData 成員設定為 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旗標時,就會使用它。

意義
HBMMENU_CALLBACK
( (HBITMAP) -1)
由擁有功能表之視窗繪製的點陣圖。 應用程式必須處理 WM_MEASUREITEMWM_DRAWITEM 訊息。
HBMMENU_MBAR_CLOSE
( (HBITMAP) 5)
選單列的 [關閉] 按鈕。
HBMMENU_MBAR_CLOSE_D
( (HBITMAP) 6)
功能表列的 [已停用關閉] 按鈕。
HBMMENU_MBAR_MINIMIZE
( (HBITMAP) 3)
功能表欄的 [最小化] 按鈕。
HBMMENU_MBAR_MINIMIZE_D
( (HBITMAP) 7)
已停用功能表欄的最小化按鈕。
HBMMENU_MBAR_RESTORE
( (HBITMAP) 2)
功能表列的 [還原] 按鈕。
HBMMENU_POPUP_CLOSE
( (HBITMAP) 8)
子選單的 [關閉] 按鈕。
HBMMENU_POPUP_MAXIMIZE
( (HBITMAP) 10)
子選單的 [最大化] 按鈕。
HBMMENU_POPUP_MINIMIZE
( (HBITMAP) 11)
子功能表的 [最小化] 按鈕。
HBMMENU_POPUP_RESTORE
( (HBITMAP) 9)
子功能表的 [還原] 按鈕。
HBMMENU_SYSTEM
( (HBITMAP) 1)
Windows 圖示或 dwItemData 中所指定視窗的圖示。

備註

MENUITEMINFO 結構會與 GetMenuItemInfoInsertMenuItemSetMenuItemInfo 函式搭配使用。

功能表可以使用文字、點陣圖或兩者來顯示專案。

注意

winuser.h 標頭會將 MENUITEMINFO 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 winuser.h (包含 Windows.h)

另請參閱

概念

GetMenuItemInfo

InsertMenuItem

功能表

參考

SetMenuItemInfo

WM_DRAWITEM

WM_MEASUREITEM