CheckMenuItem 関数 (winuser.h)

  • [アーティクル]

[CheckMenuItem は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、 SetMenuItemInfo を使用します。 ]

指定したメニュー項目のチェックマーク属性の状態を選択またはクリアに設定します。

構文

DWORD CheckMenuItem(
  [in] HMENU hMenu,
  [in] UINT  uIDCheckItem,
  [in] UINT  uCheck
);

パラメーター

[in] hMenu

種類: HMENU

目的のメニューへのハンドル。

[in] uIDCheckItem

型: UINT

uCheck パラメーターによって決定されるチェックマーク属性を設定するメニュー項目。

[in] uCheck

型: UINT

uIDCheckItem パラメーターの解釈と、メニュー項目の チェック マーク属性の状態を制御するフラグ。 このパラメーターには、MF_BYCOMMAND、MF_BYPOSITION、MF_CHECKED、MF_UNCHECKEDのいずれかを組み合わせて使用できます。

値 説明
MF_BYCOMMAND
0x00000000L
 uIDCheckItem パラメーターがメニュー項目の識別子を指定することを示します。 MF_BYCOMMANDフラグもMF_BYPOSITIONフラグも指定されていない場合は、MF_BYCOMMAND フラグが既定値です。
MF_BYPOSITION
0x00000400L
 uIDCheckItem パラメーターが、メニュー項目の 0 から始まる相対位置を指定することを示します。
MF_CHECKED
0x00000008L
 チェックマーク属性を選択した状態に設定します。
MF_UNCHECKED
0x00000000L
 チェックマーク属性をクリア状態に設定します。

戻り値

型: DWORD

戻り値は、メニュー項目の以前の状態 ( MF_CHECKED または MF_UNCHECKED) を指定します。 メニュー項目が存在しない場合、戻り値は –1 です。

解説

メニュー バーの項目にチェックマークを付けることはできません。

uIDCheckItem パラメーターは、サブメニューまたはコマンド項目を開く項目を識別します。 サブメニューを開く項目の場合、 uIDCheckItem パラメーターは項目の位置を指定する必要があります。 コマンド 項目の場合、 uIDCheckItem パラメーターは項目の位置またはその識別子を指定できます。

例

例については、「 メニューでのチェック ボックスのシミュレート」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-menu-l1-1-0 (Windows 8 で導入)

関連項目

概念

EnableMenuItem

GetMenuItemID

メニュー

リファレンス

SetMenuItemBitmaps

SetMenuItemInfo