TrackPopupMenuEx

A função TrackPopupMenuEx exibe um menu de atalho no local especificado e controla a seleção de itens no menu de atalho. No menu de atalho pode aparecer em qualquer lugar na tela.

(BOOL TrackPopupMenuEx HMENU  hmenu,  UINT  fuFlags,  int  x,  int  y,  HWND  hwnd,  LPTPMPARAMS  lptpm  );
 

Parâmetros

hmenu

Identificador para o menu de atalho seja exibido. Esse identificador pode ser obtido por chamado CreatePopupMenu função para criar um novo menu atalho ou por chamado GetSubMenu função para recuperar o identificador para um submenu associado com um item de menu existente.

fuFlags

Posicionamento e outras opções. Esse parâmetro, que pode ser zero ou mais dos valores listados com o TrackPopupMenu função, também pode incluir um dos seguintes valores:

Valor	Significado
TPM_HORIZONTAL	Se o menu não pode ser mostrado no local especificado sem sobrepor o Retangular excluído, o sistema tenta acomodar o alinhamento horizontal solicitado antes do alinhamento vertical requerido.
TPM_VERTICAL	Se o menu não pode ser mostrado no local especificado sem sobrepor o Retangular excluído, o sistema tenta acomodar o alinhamento vertical requerido antes do requerido alinhamento horizontal.

O retângulo excluído é uma parte da tela que não deve se sobrepor o menu; Ele é especificado pelo lptpm.

x

Localização horizontal do menu de atalho, em coordenadas da tela.

y

Localização vertical do menu de atalho, em coordenadas da tela.

hwnd

Identificador para a janela que possui o menu de atalho. Esta janela recebe todas as mensagens do menu. A janela não recebe uma mensagem WM_COMMAND do menu até que a função retorna.

Se você especificar TPM_NONOTIFY no parâmetro fuFlags , a função não envia mensagens para a janela identificada por hwnd. No entanto, você ainda tem que passar um identificador janela hwnd. Pode ser qualquer identificador de janela do aplicativo.

lptpm

Ponteiro para uma estrutura TPMPARAMS que especifica uma área da tela do menu não deve se sobrepor. Este parâmetro pode ser NULL.

Retornar valores

Se você especificar TPM_RETURNCMD no parâmetro fuFlags , o valor de retorno é o identificador do item de menu do item selecionado pelo usuário. Se o usuário cancela o menu sem fazer uma seleção, ou se ocorrer um erro, então o valor de retorno é zero.

Se você não especificar TPM_RETURNCMD no parâmetro fuFlags , o valor de retorno é diferente de zero se a função for bem-sucedido e zero se ele falhar. Para informações de erro estendidas get, chamar GetLastError.

Observações

Windows CE: Windows CE não oferece suporte aos seguintes sinalizadores para uFlags parâmetro

TPM_NONOTIFY

TPM_LEFTBUTTON

TPM_RIGHTBUTTON

TPM_HORIZONTAL

TPM_VERTICAL

O parâmetro lptpm deve ser definido como NULL.

QuickInfo

nbsp; Windows &NT: requer a versão 4.0 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de menus, funções de Menu, CreatePopupMenu, GetSubMenu, TPMPARAMS, TrackPopupMenu, WM_COMMAND

Index