IMenuPopup::P opup メソッド (shobjidl_core.h)

指定した画面上の場所でショートカット メニューを呼び出します。

構文

HRESULT Popup(
  [in] POINTL        *ppt,
  [in] RECTL         *prcExclude,
  [in] MP_POPUPFLAGS dwFlags
);

パラメーター

[in] ppt

種類: POINTL*

ポップアップ メニューの位置を画面座標で指定する POINTL 構造体へのポインター。 ポップアップ メニューは、 dwFlags で設定された位置フラグによって決定される、このポイントに関連して表示されます。

[in] prcExclude

種類: RECTL*

メニューの配置時に除外する四角形を指定する RECTL 構造体へのポインター。 Windows Vista では、この領域に対するメニューの配置は、 dwFlags で設定された配置フラグによって決まります。 画面全体を含めるには、このパラメーターに NULL を 指定できます。

[in] dwFlags

種類: MP_POPUPFLAGS

ポップアップ メニューの表示を制御する次の定数の 1 つ以上。

MPPF_SETFOCUS (0x00000001)

メニューが表示されたら、フォーカスが設定されている必要があります。

MPPF_INITIALSELECT (0x00000002)

メニューの最初の項目を選択する必要があります。

MPPF_NOANIMATE (0x00000004)

このショーはアニメーション化しないでください。

MPPF_KEYBOARD (0x00000010)

メニューはキーボードによってアクティブ化されます。

MPPF_REPOSITION (0x00000020)

表示されているバーの位置を変更します。

MPPF_FORCEZORDER (0x00000040)

メニュー バーはサブメニューの位置を無視する必要があります。

MPPF_FINALSELECT (0x00000080)

メニューの最後の項目を選択する必要があります。

MPPF_TOP (0x20000000)

ppt で指定したポイントの上にポップアップ メニューを表示 します。

MPPF_LEFT (0x40000000)

ppt で指定したポイントの左側にポップアップ メニューを表示します。

MPPF_RIGHT (0x60000000)

ppt で指定したポイントの右側にポップアップ メニューを表示 します。

MPPF_BOTTOM (0x80000000)

ppt で指定したポイントの下にポップアップ メニューを表示 します。

MPPF_POS_MASK (0xE0000000)

位置値MPPF_TOP、MPPF_LEFT、およびMPPF_RIGHTをマスクします。

MPPF_ALIGN_LEFT (0x02000000)

既定の配置。

MPPF_ALIGN_RIGHT (0x04000000)

ポップアップ メニューは、 prcExclude で指定された除外された四角形の右側に配置する必要があります。

戻り値

種類: HRESULT

オブジェクトがポップアップ メニューをモードレス メニューとして実装する場合は、 S_OK を返します。 それ以外の場合は、 メニューの実装の終了を示すS_FALSEを返します。

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP1 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll (バージョン 5.0 以降)