InsertMenuA 関数 (winuser.h)
メニューに新しいメニュー項目を挿入し、他の項目をメニューの下に移動します。
構文
BOOL InsertMenuA(
[in] HMENU hMenu,
[in] UINT uPosition,
[in] UINT uFlags,
[in] UINT_PTR uIDNewItem,
[in, optional] LPCSTR lpNewItem
);
パラメーター
[in] hMenu
型: HMENU
変更するメニューのハンドル。
[in] uPosition
型: UINT
uFlags パラメーターによって決定される、新しいメニュー項目を挿入する前のメニュー項目。
[in] uFlags
型: UINT
uPosition パラメーターの解釈と、新しいメニュー項目の内容、外観、および動作を制御します。 このパラメーターには、次の必須値のいずれかを含める必要があります。
パラメーターには、次の値の少なくとも 1 つも含める必要があります。
価値 | 意味 |
---|---|
|
メニュー項目としてビットマップを使用します。 lpNewItem パラメーターには、ビットマップへのハンドルが含まれています。 |
|
メニュー項目の横にチェック マークを付けます。 アプリケーションがチェック マーク ビットマップを提供する場合 (SetMenuItemBitmaps |
|
メニュー項目を無効にして、選択できないようにしますが、グレー表示しません。 |
|
選択できるようにメニュー項目を有効にし、灰色の状態から復元します。 |
|
メニュー項目を無効にし、グレー表示して選択できないようにします。 |
|
メニュー バーの MF_MENUBREAK フラグと同じように機能します。 ドロップダウン メニュー、サブメニュー、またはショートカット メニューの場合、新しい列は、縦線で古い列から分離されます。 |
|
列を区切らずに、新しい行 (メニュー バーの場合) または新しい列 (ドロップダウン メニュー、サブメニュー、またはショートカット メニューの場合) に項目を配置します。 |
|
アイテムが所有者描画アイテムであることを指定します。 メニューを初めて表示する前に、メニューを所有するウィンドウは、メニュー項目の幅と高さを取得する WM_MEASUREITEM メッセージを受け取ります。 その後、メニュー項目の外観を更新する必要があるときは常に、WM_DRAWITEM メッセージが所有者ウィンドウのウィンドウ プロシージャに送信されます。 |
|
メニュー項目がドロップダウン メニューまたはサブメニューを開くかどうかを指定します。 uIDNewItem パラメーターは、ドロップダウン メニューまたはサブメニューへのハンドルを指定します。 このフラグは、メニュー バーにメニュー名を追加したり、サブメニューを開くメニュー項目をドロップダウン メニュー、サブメニュー、またはショートカット メニューに追加するために使用します。 |
|
水平分割線を描画します。 このフラグは、ドロップダウン メニュー、サブメニュー、またはショートカット メニューでのみ使用されます。 線を灰色表示、無効化、または強調表示することはできません。 |
|
メニュー項目がテキスト文字列であることを指定します。lpNewItem パラメーターは、文字列へのポインターです。 |
|
メニュー項目の横にチェック マークを付けません (既定)。 アプリケーションがチェック マーク ビットマップを提供する場合 (setMenuItemBitmaps 関数 |
[in] uIDNewItem
型: UINT_PTR
新しいメニュー項目の識別子。または、uFlags パラメーターに MF_POPUP フラグが設定されている場合は、ドロップダウン メニューまたはサブメニューへのハンドル。
[in, optional] lpNewItem
型: LPCTSTR
新しいメニュー項目の内容。 lpNewItem の解釈は、次のように、uFlags パラメーターに MF_BITMAP、MF_OWNERDRAW、または MF_STRING フラグが含まれているかどうかによって異なります。
価値 | 意味 |
---|---|
|
ビットマップ ハンドルを格納します。 |
|
メニュー項目に関連する追加データを維持するために使用できる、アプリケーション指定の値が含まれます。 この値は、メニュー項目の作成時または外観の更新時に送信される WM_MEASUREITEM または WM_DRAWITEM メッセージの lParam パラメーターによって指される構造体の itemData メンバーにあります。 |
|
null で終わる文字列 (既定値) へのポインターを格納します。 |
戻り値
型: BOOL
関数が成功した場合、戻り値は 0 以外です。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError
備考
メニューが表示ウィンドウ内にあるかどうかに関係なく、メニューが変更されるたびに、アプリケーションは DrawMenuBar 関数を呼び出す必要があります。
次のフラグ のグループを一緒に使用することはできません。
- MF_BYCOMMAND と MF_BYPOSITION
- MF_DISABLED、MF_ENABLED、および MF_GRAYED
- MF_BITMAP、MF_STRING、MF_OWNERDRAW、および MF_SEPARATOR
- MF_MENUBARBREAK と MF_MENUBREAK
- MF_CHECKED と MF_UNCHECKED
手記
winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InsertMenu を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | winuser.h (Windows.h を含む) |
ライブラリ | User32.lib |
DLL | User32.dll |
API セットの | ext-ms-win-ntuser-menu-l1-1-0 (Windows 8 で導入) |
関連項目
AppendMenu を
概念
DeleteMenu の
InsertMenuItem の
その他のリソース を
リファレンス
RemoveMenu の