Compartilhar via


WM_CONTEXTMENU mensagem

Notifica uma janela de que o usuário deseja que um menu de contexto apareça. O usuário pode ter clicado no botão direito do mouse (clicado com o botão direito do mouse) na janela, pressionado Shift+F10 ou pressionado a tecla de aplicativos (tecla de menu de contexto) disponível em alguns teclados.

#define WM_CONTEXTMENU                  0x007B

Parâmetros

wParam

Um identificador para a janela na qual o usuário clicou com o botão direito do mouse. Essa janela pode ser uma janela filho da janela que recebe a mensagem. Para obter mais informações sobre como processar essa mensagem, consulte a seção Comentários.

lParam

A palavra de baixa ordem especifica a posição horizontal do cursor, nas coordenadas da tela, no momento do clique do mouse.

A palavra de alta ordem especifica a posição vertical do cursor, nas coordenadas da tela, no momento do clique do mouse.

Valor retornado

Sem valor de retorno.

Comentários

Uma janela pode processar essa mensagem exibindo um menu de atalho usando as funções TrackPopupMenu ou TrackPopupMenuEx . Para obter as posições horizontal e vertical, use o código a seguir.

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam); 

Se uma janela não exibir um menu de atalho, ela deverá passar essa mensagem para a função DefWindowProc . Se uma janela for uma janela filho, DefWindowProc enviará a mensagem para o pai. Caso contrário, DefWindowProc exibirá um menu de atalho padrão se a posição especificada estiver no legenda da janela.

DefWindowProc gera a mensagem WM_CONTEXTMENU quando processa a mensagem WM_RBUTTONUP ou WM_NCRBUTTONUP ou quando o usuário digita SHIFT+F10. A mensagem WM_CONTEXTMENU também é gerada quando o usuário pressiona e libera a tecla VK_APPS .

Se o menu de contexto for gerado do teclado, por exemplo, se o usuário digitar SHIFT+F10, as coordenadas x e y serão -1 e o aplicativo deverá exibir o menu de contexto no local da seleção atual e não em (xPos, yPos).

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclua Windows.h)

Confira também

Referência

DefWindowProc

GET_X_LPARAM

GET_Y_LPARAM

Trackpopupmenu

Trackpopupmenuex

WM_NCRBUTTONUP

WM_RBUTTONUP

Conceitual

Menus