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

取得または設定するメンバーを示します。 このメンバーには、次の値の 1 つ以上を指定できます。

fType

型: UINT

メニュー項目の種類。 このメンバーには、次の値の 1 つ以上を指定できます。

MFT_BITMAP、MFT_SEPARATOR、およびMFT_STRINGの値を相互に組み合わせることはできません。 fMask を MIIM_TYPE に設定して fType を使用します。

fType は、 fMask の値が MIIM_FTYPE の場合にのみ使用されます。

fState

型: UINT

メニュー項目の状態。 このメンバーには、これらの値の 1 つ以上を指定できます。 fState を使用するには、 fMask を MIIM_STATE に設定 します。

wID

型: UINT

メニュー項目を識別するアプリケーション定義の値。 wID を使用するには、fMask を MIIM_ID に設定します。

hSubMenu

種類: HMENU

メニュー項目に関連付けられているドロップダウン メニューまたはサブメニューへのハンドル。 メニュー項目がドロップダウン メニューまたはサブメニューを開く項目でない場合、このメンバーは NULL になります。 hSubMenu を使用するには、fMask を MIIM_SUBMENU に設定します。

hbmpChecked

種類: HBITMAP

項目が選択されている場合に、項目の横に表示するビットマップへのハンドル。 このメンバーが NULL の場合は、既定のビットマップが使用されます。 MFT_RADIOCHECK型の値が指定されている場合、既定のビットマップは箇条書きになります。 それ以外の場合は、チェックマークです。 hbmpChecked を使用するには、fMask を MIIM_CHECKMARKS に設定します。

hbmpUnchecked

種類: HBITMAP

項目の横に表示するビットマップへのハンドル (選択されていない場合)。 このメンバーが NULL の場合、ビットマップは使用されません。 hbmpUnchecked を使用するには、fMask を MIIM_CHECKMARKS に設定します。

dwItemData

種類: ULONG_PTR

メニュー項目に関連付けられているアプリケーション定義の値。 dwItemData を使用するには、fMask を MIIM_DATA に設定します。

dwTypeData

種類: LPTSTR

メニュー項目の内容。 このメンバーの意味は fType の値によって異なり、 MIIM_TYPE フラグが fMask メンバーに設定されている場合にのみ使用されます。

MFT_STRING型のメニュー項目を取得するには、MENUITEMINFO の dwTypeData メンバーを NULL に設定してから GetMenuItemInfo を呼び出して、文字列のサイズを検索します。 cch+1 の値は、必要なサイズです。 次に、このサイズのバッファーを割り当て、 dwTypeData 内のバッファーへのポインターを配置して cch をインクリメントし、 GetMenuItemInfo をもう一度呼び出してバッファーに文字列を入力します。 取得したメニュー項目が他の型の場合、 GetMenuItemInfo は dwTypeData メンバーを 、fType メンバーによって指定された型の値に設定します。

SetMenuItemInfo 関数で を使用する場合、このメンバーには、fType メンバーによって型が指定された値が含まれている必要があります。

dwTypeData は、fMask メンバーでMIIM_STRING フラグが設定されている場合にのみ使用されます

cch

型: UINT

MFT_STRINGの種類のメニュー項目に関する情報を受信したときの、メニュー項目のテキストの長さ (文字単位)。 ただし、 cch は、 MIIM_TYPE フラグが fMask メンバーで設定され、それ以外の場合は 0 の場合にのみ使用されます。 また、メニュー項目の内容が SetMenuItemInfo を呼び出して設定されている場合、cch は無視されます。

GetMenuItemInfo を呼び出す前に、アプリケーションは、dwTypeData メンバーが指すバッファーの長さに cch を設定する必要があることに注意してください。 取得したメニュー項目が (fType メンバーによって示されているように) MFT_STRING型である場合、GetMenuItemInfo は cch をメニュー項目のテキストの長さに変更します。 取得したメニュー項目が他の種類の場合、 GetMenuItemInfo は cch フィールドを 0 に設定します。

cch メンバーは、fMask メンバーで MIIM_STRING フラグが設定されている場合に使用されます。

hbmpItem

種類: HBITMAP

表示されるビットマップへのハンドル。または、次の表のいずれかの値を指定できます。 fMask メンバーでMIIM_BITMAP フラグが設定されている場合に使用されます。

注釈

MENUITEMINFO 構造体は、GetMenuItemInfo、InsertMenuItem、および SetMenuItemInfo 関数と共に使用されます。

メニューには、テキスト、ビットマップ、またはその両方を使用して項目を表示できます。

要件

関連項目

概念

GetMenuItemInfo

InsertMenuItem

メニュー

リファレンス

SetMenuItemInfo

WM_DRAWITEM

WM_MEASUREITEM