WM_SYSCOMMAND mensagem
Uma janela recebe essa mensagem quando o usuário escolhe um comando no menu Janela (anteriormente conhecido como sistema ou menu de controle) ou quando o usuário escolhe o botão maximizar, minimizar botão, botão restaurar ou fechar botão.
#define WM_SYSCOMMAND 0x0112
Exemplo
case WM_SYSCOMMAND:
if ((wParam & 0xFFF0) == SC_CLOSE)
{
EndDialog (hDlg, TRUE);
return(TRUE);
}
break;
Exemplo das Amostras do Windows Classic no GitHub.
Parâmetros
-
wParam
-
O tipo de comando do sistema solicitado. Esse parâmetro pode usar um dos valores a seguir.
Valor Significado - SC_CLOSE
- 0xF060
Fecha a janela. - SC_CONTEXTHELP
- 0xF180
Altera o cursor para um ponto de interrogação com um ponteiro. Se o usuário clicar em um controle na caixa de diálogo, o controle receberá uma mensagem WM_HELP . - SC_DEFAULT
- 0xF160
Seleciona o item padrão; o usuário clicou duas vezes no menu da janela. - SC_HOTKEY
- 0xF150
Ativa a janela associada à tecla de acesso especificada pelo aplicativo. O parâmetro lParam identifica a janela a ser ativada. - SC_HSCROLL
- 0xF080
Rola horizontalmente. - SCF_ISSECURE
- 0x00000001
Indica se o protetor de tela é seguro. - SC_KEYMENU
- 0xF100
Recupera o menu da janela como resultado de um pressionamento de tecla. Para obter mais informações, consulte a seção Comentários. - SC_MAXIMIZE
- 0xF030
Maximiza a janela. - SC_MINIMIZE
- 0xF020
Minimiza a janela. - SC_MONITORPOWER
- 0xF170
Define o estado da exibição. Esse comando dá suporte a dispositivos que têm recursos de economia de energia, como um computador pessoal movido a bateria.
O parâmetro lParam pode ter os seguintes valores:- -1 (a tela está ativada)
- 1 (a tela vai para baixo consumo de energia)
- 2 (a exibição está sendo desligada)
- SC_MOUSEMENU
- 0xF090
Recupera o menu da janela como resultado de um clique do mouse. - SC_MOVE
- 0xF010
Move a janela. - SC_NEXTWINDOW
- 0xF040
Move para a próxima janela. - SC_PREVWINDOW
- 0xF050
Move para a janela anterior. - SC_RESTORE
- 0xF120
Restaura a janela para sua posição e tamanho normais. - SC_SCREENSAVE
- 0xF140
Executa o aplicativo de proteção de tela especificado na seção [inicialização] do arquivo System.ini. - SC_SIZE
- 0xF000
Dimensiona a janela. - SC_TASKLIST
- 0xF130
Ativa o menu Iniciar . - SC_VSCROLL
- 0xF070
Rola verticalmente. -
lParam
-
A palavra de baixa ordem especifica a posição horizontal do cursor, em coordenadas de tela, se um comando de menu de janela for escolhido com o mouse. Caso contrário, esse parâmetro não será usado.
A palavra de alta ordem especifica a posição vertical do cursor, em coordenadas de tela, se um comando de menu de janela for escolhido com o mouse. Esse parâmetro será 1 se o comando for escolhido usando um acelerador de sistema ou zero se estiver usando um mnemônico.
Valor retornado
Um aplicativo deverá retornar zero se processar essa mensagem.
Comentários
Para obter as coordenadas de posição nas coordenadas da tela, use o seguinte código:
xPos = GET_X_LPARAM(lParam); // horizontal position
yPos = GET_Y_LPARAM(lParam); // vertical position
A função DefWindowProc executa a solicitação de menu de janela para as ações predefinidas especificadas na tabela anterior.
Em mensagens WM_SYSCOMMAND , os quatro bits de ordem baixa do parâmetro wParam são usados internamente pelo sistema. Para obter o resultado correto ao testar o valor de wParam, um aplicativo deve combinar o valor 0xFFF0 com o valor wParam usando o operador AND bit a bit.
Os itens de menu em um menu de janela podem ser modificados usando as funções GetSystemMenu, AppendMenu, InsertMenu, ModifyMenu, InsertMenuItem e SetMenuItemInfo . Os aplicativos que modificam o menu da janela devem processar mensagens WM_SYSCOMMAND .
Um aplicativo pode executar qualquer comando do sistema a qualquer momento passando uma mensagem de WM_SYSCOMMAND para DefWindowProc. Todas as mensagens WM_SYSCOMMAND não manipuladas pelo aplicativo devem ser passadas para DefWindowProc. Todos os valores de comando adicionados por um aplicativo devem ser processados pelo aplicativo e não podem ser passados para DefWindowProc.
Se a proteção por senha estiver habilitada pela política, a proteção de tela será iniciada independentemente do que um aplicativo faz com a notificação de SC_SCREENSAVE mesmo que não a passe para DefWindowProc.
As teclas aceleradoras definidas para escolher itens no menu da janela são convertidas em mensagens WM_SYSCOMMAND ; todos os outros pressionamentos de teclas de acelerador são convertidos em mensagens WM_COMMAND .
Se o wParam for SC_KEYMENU, lParam conterá o código de caractere da chave usada com a tecla ALT para exibir o menu pop-up. Por exemplo, pressionar ALT+F para exibir o pop-up Arquivo causará um WM_SYSCOMMAND com wParam igual a SC_KEYMENU e lParam igual a 'f'.
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 |
|
Confira também
-
Referência
-
Conceitual