CMenu::TrackPopupMenuEx

Artigo
06/10/2015

Exibe um menu pop-up flutuante no local especificado e controla a seleção de itens de menu pop-up.

BOOL TrackPopupMenuEx( 
   UINT fuFlags, 
   int x, 
   int y, 
   CWnd* pWnd, 
   LPTPMPARAMS lptpm 
);

Parâmetros

fuFlags
Especifica mais funções para o menu estendido. Para obter uma lista de todos os valores e seu significado, consulte TrackPopupMenuEx.
x
Especifica a posição horizontal em coordenadas da tela de menus pop-up.
s
Especifica a posição vertical em coordenadas da tela a parte superior do menu na tela.
pWnd
Um ponteiro para a janela que possui o menu pop-up e que recebe mensagens de menu criado. Esta janela pode ser qualquer janela do aplicativo atual mas não pode ser NULO. Se você especificar TPM_NONOTIFY no parâmetro de fuFlags , a função não envia nenhuma mensagens a pWnd. a função deve retornar para a janela apontada por pWnd para receber a mensagem de WM_COMMAND .
lptpm
O ponteiro a estrutura de TPMPARAMS que especifica uma área da tela o menu não deve sobrepor. Este parâmetro pode ser NULO.

Valor de retorno

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

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

Comentários

Um menu pop-up flutuante pode aparecer em qualquer lugar na tela. Para obter mais informações sobre tratamento de erros durante ao criar menus pop-up, consulte TrackPopupMenuEx.