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.