CheckMenuRadioItem 関数 (winuser.h)

  • [アーティクル]

指定したメニュー項目をチェックし、ラジオ項目にします。 同時に、 関数は、関連付けられているグループ内の他のすべてのメニュー項目をクリアし、それらの項目のラジオ項目の種類フラグをクリアします。

構文

BOOL CheckMenuRadioItem(
  [in] HMENU hmenu,
  [in] UINT  first,
  [in] UINT  last,
  [in] UINT  check,
  [in] UINT  flags
);

パラメーター

[in] hmenu

種類: HMENU

メニュー項目のグループを含むメニューへのハンドル。

[in] first

型: UINT

グループ内の最初のメニュー項目の識別子または位置。

[in] last

型: UINT

グループ内の最後のメニュー項目の識別子または位置。

[in] check

型: UINT

チェックするメニュー項目の識別子または位置。

[in] flags

型: UINT

idFirst、idLast、idCheck の意味を示します。 このパラメーターが MF_BYCOMMANDの場合、他のパラメーターはメニュー項目識別子を指定します。 MF_BYPOSITIONされている場合、他のパラメーターはメニュー項目の位置を指定します。

戻り値

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 拡張エラー情報を取得するには、 GetLastError 関数を使用します。

解説

CheckMenuRadioItem 関数は、idCheck で指定されたアイテムのMFT_RADIOCHECK型フラグとMFS_CHECKED状態を設定し、同時にグループ内の他のすべての項目の両方のフラグをクリアします。 選択した項目は、チェックマークビットマップではなく、箇条書きビットマップを使用して表示されます。

メニュー項目の種類と状態フラグの詳細については、 MENUITEMINFO 構造体を参照してください。

例

例については、「 カスタム チェックマーク ビットマップの使用例」を参照してください。

要件

   
サポートされている最小のクライアント 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 で導入)

関連項目

概念

MENUITEMINFO

メニュー

参照