TrackPopupMenu

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

(BOOL TrackPopupMenu HMENU  hMenu, / / identificador para o menu de atalhoUINTuFlags, / / posição da tela e mouse-botão bandeirasint x, / / coordena a posição horizontal, na telaint y, / / coordena a posição vertical, em tela intnReserved, / / reservado, deve ser zeroHWNDhWnd, / / identificador para janela de proprietárioCONST RECT* prcRect / / ignorado);
 

Parâmetros

hMenu
Identificador para o menu de atalho seja exibido. O identificador pode ser obtido por chamado CreatePopupMenu para criar um novo menu atalho, ou por chamado GetSubMenu para recuperar o identificador para um submenu associado com um item de menu existente.
uFlags
Um conjunto de bit sinalizadores que especificar as opções de função.

Use uma das seguintes constantes de sinalizador de bit para especificar como a função posiciona o menu atalho horizontalmente.
Valor Significado
TPM_CENTERALIGN Se este sinalizador estiver definido, a função centraliza o menu atalho horizontalmente relativo para a coordenar especificado pelo x parâmetro.
TPM_LEFTALIGN Se este sinalizador estiver definido, a função posiciona o menu atalho para que seu lado esquerdo é alinhado com a coordenar especificado pelo x parâmetro.
TPM_RIGHTALIGN Posiciona o menu atalho para que seu lado direito está alinhado com a coordenar especificado pelo x parâmetro.

Use uma das seguintes constantes de sinalizador de bit para especificar como a função posiciona o menu atalho verticalmente.
Valor Significado
TPM_BOTTOMALIGN Se este sinalizador estiver definido, a função posiciona o menu atalho para que seu lado inferior é alinhado com a coordenar especificado pelo y parâmetro.
TPM_TOPALIGN Se este sinalizador estiver definido, a função posiciona o menu atalho para que seu lado superior está alinhado com a coordenar especificado pelo y parâmetro.
TPM_VCENTERALIGN Se este sinalizador estiver definido, a função centraliza o menu de atalho verticalmente, relativo para a coordenar especificado pelo y parâmetro.

Usar as seguintes constantes do sinalizador de bit para determinar a seleção de usuário sem ter que configurar uma janela pai para o menu.
Valor Significado
TPM_NONOTIFY Se este sinalizador estiver definido, a função não envia mensagens de notificação quando o usuário clica em um item de menu.
TPM_RETURNCMD Se este sinalizador estiver definido, a função retorna o identificador do item de menu de seleção do usuário no valor de retorno.

Uso um do seguinte bit sinalizador constantes especificar qual mouse button as faixas de menu de atalho.
Valor Significado
TPM_LEFTBUTTON Se este sinalizador estiver definido, o usuário pode selecionar itens de menu com apenas o botão esquerdo do mouse.
TPM_RIGHTBUTTON Se este sinalizador estiver definido, o usuário pode selecionar itens de menu com ambos os botões esquerdo e direito do mouse.

x
Especifica a localização horizontal do menu de atalho, em coordenadas da tela.
y
Especifica o local vertical do menu de atalho, em coordenadas da tela.
nReserved
Reservados; deve ser zero.
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 in a uFlags parâmetro, a função não envia mensagens para a janela identificada por hWnd. No entanto, você ainda deve passar um identificador de janela em hWnd. Pode ser qualquer identificador de janela do aplicativo.

prcRect
Ignorada.

Retornar valores

Se você especificar TPM_RETURNCMD in a uFlags parâmetro, 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 in a uFlags parâmetro, 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

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 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, RECT, WM_COMMAND

Index