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