Edit

ITrackShellMenu::Popup method (shdeprecated.h)

  • Article

Displays a modal pop-up menu at a specific location.

Syntax

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

Parameters

[in] hwnd

Type: HWND

The handle of the parent window of the pop-up menu.

[in] ppt

Type: POINTL*

A pointer to a POINTL structure that specifies an initial point in screen coordinates. The pop-up menu is displayed in relation to this point as determined by the position flags set in dwFlags.

[in] prcExclude

Type: RECTL*

A pointer to a RECTL structure that specifies the rectangle to exclude when positioning the menu. The alignment of the menu in relation to this area is determined by the alignment flags set in dwFlags. This parameter can be set to NULL.

[in] dwFlags

Type: MP_POPUPFLAGS

One or more of the MP_POPUPFLAGS constants that specify options involved in the display of the pop-up menu.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shdeprecated.h
DLL Shell32.dll