Método IMenuPopup::P opup (shobjidl_core.h)

Invoca el menú contextual en una ubicación en pantalla especificada.

Sintaxis

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

Parámetros

[in] ppt

Tipo: POINTL*

Puntero a una estructura POINTL que especifica la ubicación del menú emergente en coordenadas de pantalla. El menú emergente se muestra en relación con este punto determinado por las marcas de posición establecidas en dwFlags.

[in] prcExclude

Tipo: RECTL*

Puntero a una estructura RECTL que especifica el rectángulo que se va a excluir al colocar el menú. En Windows Vista, la alineación del menú en relación con esta área viene determinada por las marcas de alineación establecidas en dwFlags. Este parámetro puede ser NULL para incluir toda la pantalla.

[in] dwFlags

Tipo: MP_POPUPFLAGS

Una o varias de las siguientes constantes que controlan la presentación del menú emergente.

MPPF_SETFOCUS (0x00000001)

El menú debe tener el foco cuando aparezca.

MPPF_INITIALSELECT (0x00000002)

Se debe seleccionar el primer elemento del menú.

MPPF_NOANIMATE (0x00000004)

No animes este programa.

MPPF_KEYBOARD (0x00000010)

El teclado activa el menú.

MPPF_REPOSITION (0x00000020)

Cambiar la posición de la barra mostrada.

MPPF_FORCEZORDER (0x00000040)

La barra de menús debe omitir las posiciones del submenú.

MPPF_FINALSELECT (0x00000080)

Se debe seleccionar el último elemento del menú.

MPPF_TOP (0x20000000)

Muestra el menú emergente encima del punto especificado en ppt.

MPPF_LEFT (0x40000000)

Muestra el menú emergente a la izquierda del punto especificado en ppt.

MPPF_RIGHT (0x60000000)

Muestra el menú emergente a la derecha del punto especificado en ppt.

MPPF_BOTTOM (0x80000000)

Muestra el menú emergente debajo del punto especificado en ppt.

MPPF_POS_MASK (0xE0000000)

Máscara para los valores de posición MPPF_TOP, MPPF_LEFT y MPPF_RIGHT.

MPPF_ALIGN_LEFT (0x02000000)

Alineación predeterminada.

MPPF_ALIGN_RIGHT (0x04000000)

El menú emergente debe alinearse a la derecha del rectángulo excluido especificado por prcExclude.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si el objeto implementa el menú emergente como menú modela. De lo contrario, devuelve S_FALSE, que indica el final de la implementación del menú.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)
Archivo DLL	Shell32.dll (versión 5.0 o posterior)