winuser.h


TrackPopupMenu

la función TrackPopupMenu muestra un menú de atajo en la posición especificada y rastrea la selección de ítems del menú. El menú de atajo puede aparecer en cualquier lugar de la pantalla.

Sintaxis

BOOL TrackPopupMenu(
    HMENU hMenu,         // manipulador de menú de atajo
    UINT uFlags,         // banderas de posición de pantalla y de botones de ratón
    int x,               // posición horizontal, en coordenadas de pantalla
    int y,               // posición vertical, en coordenadas de pantalla
    int nReserved,       // reservado, debe ser cero
    HWND hWnd,           // manipulador de ventana propietaria
    CONST RECT *prcRect  // puntero a RECT que especifica un área no-rechazo
   );

Parámetros

hMenu: identifica el menú de atajo a mostrar. El manipulador se puede obtener mediante una llamada a CreatePopupMenu para crear un menú de atajo, o mediante una llamada a GetSubMenu para recuperar un manipulador de un submenú asociado con un ítem de menú existente.

uFlags: un conjunto de banderas de bit que especifican opciones de la función.

Usar uno de las siguientes constantes de banderas de bit para especificar el modo en que la función coloca el menú emergente horizontalmente:

Valor Significado
TPM_CENTERALIGN Si esta bandera está activa, la función centra el menú de atajo horizontalmente con relación a la coordenada especificada por el parámetro x.
TPM_LEFTALIGN Si esta bandera está activa, la función coloca el menú de atajo de modo que su lado izquierdo esté alineado con la coordenada especificada por el parámetro x.
TPM_RIGHTALIGN Coloca el menú de atajo de modo que su lado derecho esté alineado con la coordenada especificada por el parámetro x.

Usar uno de las siguientes constantes de bandera de bit para especificar qué botón del ratón rastrea el menú de atajo:

Valor Significado
TPM_LEFTBUTTON Si esta bandera está activa, el menú de atajo rastrea el botón izquierdo del ratón.
TPM_RIGHTBUTTON Si esta bandera está activa, el menú de atajo rastrea el botón derecho del ratón.

x: especifica la posición horizontal del menú de atajo, en coordenadas de pantalla.

y: especifica la posición vertical del menú de atajo, en coordenadas de pantalla.

nReserved: reservado; debe ser cero.

hWnd: identifica la ventana a la que pertenece el menú de atajo. Esta ventana recibirá todos los mensajes del menú. La ventana no recibe un mensaje WM_COMMAND desde el menú hasta que la función regrese.

prcRect: apunta a una estructura RECT que especifica la porción de pantalla en la que el usuario puede seleccionar sin rechazar el menú de atajo. Si este parámetro es NULL, el menú de atajo será rechazado si el usuario hace clic fuera del menú de atajo.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a GetLastError.