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
| 価値 | 意味 |
|---|---|
|
ビットマップを使用してメニュー項目を表示します。
dwTypeData メンバーの下位ワードはビットマップ ハンドルであり、cch メンバーは無視されます。
|
|
メニュー項目を新しい行 (メニュー バーの場合) または新しい列 (ドロップダウン メニュー、サブメニュー、またはショートカット メニューの場合) に配置します。 ドロップダウン メニュー、サブメニュー、またはショートカット メニューの場合、新しい列と古い列を縦線で区切ります。 |
|
メニュー項目を新しい行 (メニュー バーの場合) または新しい列 (ドロップダウン メニュー、サブメニュー、またはショートカット メニューの場合) に配置します。 ドロップダウン メニュー、サブメニュー、またはショートカット メニューの場合、列は垂直線で区切りません。 |
|
メニューを所有するウィンドウにメニュー項目を描画する責任を割り当てます。 このウィンドウは、メニューが初めて表示される前に WM_MEASUREITEM メッセージを受け取り、メニュー項目の外観を更新する必要がある場合は常に WM_DRAWITEM メッセージを受け取ります。 この値を指定すると、dwTypeData メンバーには、アプリケーション定義の値が含まれます。 |
|
|
|
メニュー項目とその後の項目を右揃えします。 この値は、メニュー項目がメニュー バーにある場合にのみ有効です。 |
|
メニューが右から左にカスケードするように指定します (既定値は左から右)。 これは、アラビア語やヘブライ語などの右から左の言語をサポートするために使用されます。 |
|
メニュー項目が区切り記号であることを指定します。 メニュー項目の区切り記号は、水平分割線として表示されます。 dwTypeData および cch メンバーは無視されます。 この値は、ドロップダウン メニュー、サブメニュー、またはショートカット メニューでのみ有効です。 |
|
テキスト文字列を使用してメニュー項目を表示します。
dwTypeData メンバーは null で終わる文字列へのポインターであり、cch メンバーは文字列の長さです。
MFT_STRING は MIIM_STRINGに置き換えられます。 |
fState
型: UINT
メニュー項目の状態。 このメンバーには、これらの値の 1 つ以上を指定できます。 fMask
wID
型: UINT
メニュー項目を識別するアプリケーション定義の値。
hSubMenu
型: HMENU
メニュー項目に関連付けられているドロップダウン メニューまたはサブメニューへのハンドル。 メニュー項目がドロップダウン メニューまたはサブメニューを開く項目でない場合、このメンバーは NULL
hbmpChecked
型: HBITMAP
選択されている場合に項目の横に表示するビットマップのハンドル。 このメンバーが NULL
hbmpUnchecked
型: HBITMAP
項目の横に表示するビットマップのハンドル (選択されていない場合)。 このメンバーが NULL
dwItemData
型: ULONG_PTR
メニュー項目に関連付けられているアプリケーション定義の値。
dwTypeData
型: LPTSTR
メニュー項目の内容。 このメンバーの意味は、fType の値によって異なり、MIIM_TYPE フラグが fMask メンバーに設定されている場合にのみ使用されます。
SetMenuItemInfo 関数と共に使用する場合、このメンバーには、fType メンバーで指定された型の値が含まれている必要があります。
dwTypeData は、MIIM_STRING フラグが fMask メンバーに設定されている場合にのみ使用されます
cch
型: UINT
MFT_STRING の種類のメニュー項目に関する情報を受け取った場合の、メニュー項目のテキストの長さ (文字数)。 ただし、cch は、MIIM_TYPE フラグが fMask メンバーに設定され、それ以外の場合は 0 の場合にのみ使用されます。 また、
GetMenuItemInfo
cch メンバーは、fMask メンバーで MIIM_STRING フラグが設定されている場合に使用されます。
hbmpItem
型: HBITMAP
表示するビットマップのハンドル、または次の表のいずれかの値を指定できます。 これは、fMask メンバーで MIIM_BITMAP フラグが設定されている場合に使用されます。
| 価値 | 意味 |
|---|---|
|
メニューを所有するウィンドウによって描画されるビットマップ。 アプリケーションは、WM_MEASUREITEM と WM_DRAWITEM メッセージを処理する必要があります。 |
|
メニュー バーの [閉じる] ボタン。 |
|
メニュー バーの閉じるボタンを無効にしました。 |
|
メニュー バーの最小化ボタン。 |
|
メニュー バーの最小化ボタンを無効にしました。 |
|
メニュー バーの [復元] ボタン。 |
|
サブメニューの [閉じる] ボタン。 |
|
サブメニューの最大化ボタン。 |
|
サブメニューの最小化ボタン。 |
|
サブメニューの [復元] ボタン。 |
|
windows アイコンまたは dwItemDataで指定されたウィンドウ |
備考
メニューには、テキスト、ビットマップ、またはその両方を使用して項目を表示できます。
手記
winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして MENUITEMINFO を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー | winuser.h (Windows.h を含む) |
関連項目
概念
GetMenuItemInfo の
InsertMenuItem の
リファレンス