CMenu::CheckMenuItem

[アーティクル]
08/09/2011

ポップアップメニューのメニュー項目にチェックマークを付けたり、メニュー項目からチェックマークを削除したりします。

UINT CheckMenuItem(
   UINT nIDCheckItem,
   UINT nCheck 
);

パラメーター

nIDCheckItem
nCheck で指定された方法でチェックされるメニュー項目を指定します。
nCheck
メニュー項目のチェック方法と、メニュー内での項目の位置の決め方を指定します。パラメーター nCheck には、MF_CHECKED、MF_UNCHECKED のいずれかと MF_BYPOSITION、MF_BYCOMMAND のいずれかを組み合わせて指定します。これらのフラグは、ビットごとの OR 演算子を使って組み合わせることができます。これらは次のような意味を持ちます。
- MF_BYCOMMAND パラメーターを既存のメニュー項目のコマンド ID で指定することを示します。これは、既定の設定です。
- MF_BYPOSITION パラメーターで既存のメニュー項目の位置を指定することを示します。最初の項目位置は 0 です。
- MF_CHECKED MF_UNCHECKED とトグルで動作します。既定のチェックマークを項目の隣に付けます。
- MF_UNCHECKED MF_CHECKED とトグルで動作します。項目の隣からチェックマークを削除します。

戻り値

アイテムの以前の状態:MF_CHECKED または MF_UNCHECKED、またはメニュー項目が存在しなかった場合に 0 xffffffff。

解説

パラメーター nIDCheckItem には、変更される項目を指定します。

パラメーター nIDCheckItem には、メニュー項目だけでなく、ポップアップメニュー項目も指定できます。ポップアップメニュー項目のチェックには特別な手順は必要ではありません。トップレベルメニュー項目はチェックできません。ポップアップメニュー項目は、関連付けられたメニュー項目 ID を持たないので、その位置を指定してチェックします。