CWnd::OnSysCommand

Artigo
08/25/2010

A estrutura chama esta função de membro quando o usuário seleciona um comando no menu de controle ou quando o usuário seleciona a maximizar ou no botão Minimizar.

afx_msg void OnSysCommand(
   UINT nID,
   LPARAM lParam 
);

Parâmetros

nID
Especifica o tipo de comando de sistema solicitado.Esse parâmetro pode ser qualquer um dos seguintes valores:
- SC_CLOSE fechar o CWnd objeto.
- SC_HOT chave Ativar o CWnd objeto associado com o aplicativo especificado pelo hot chave. A palavra de ordem inferior de lParam identifica o HWND da janela para ativar.
- SC_H rolar rolar horizontalmente.
- SC_KEYMENU Recupere um menu por meio de um pressionamento de tecla.
- SC_MAXIMIZE (or SC_ZOOM) maximizar o CWnd objeto.
- SC_MINIMIZE (or SC_ICON) Minimizar o CWnd objeto.
- SC_MOUSEMENU Recupere um menu por meio de um clicar do mouse.
- SC_MOVE Mover o CWnd objeto.
- SC_NEXTWINDOW Mover para a próxima janela.
- SC_PREVWINDOW Mover para a janela anterior.
- SC_RESTORE Restaure janela normal posição e dimensionar.
- SC_SCREENSAVE Executa o aplicativo de proteção de tela especificado na seção [boot] do arquivo sistema.ini.
- SC_SIZE Dimensionar o CWnd objeto.
- SC_TASKLIST Executar ou ativar o aplicativo Gerenciador de tarefas do Windows.
- SC_VSCROLL Role verticalmente.
lParam
Se um comando de menu de controle é escolhido com o mouse, lParam contém as coordenadas do cursor. A palavra de ordem inferior contém as coordenadas x e a palavra de ordem superior contém a coordenada y.Caso contrário, este parâmetro não é usado.
- SC_HOTKEY Ative a janela associada a tecla de acesso do aplicativo especificado.A palavra de ordem inferior de lParam identifica a janela para ativar.
- SC_SCREENSAVE Executa a aplicação de economia de tela especificada na seção do painel de controle do área de trabalho.

Comentários

Por padrão, OnSysCommand executa a solicitação do menu de controle para as ações predefinidas especificadas na tabela anterior.

In WM_SYSCOMMAND mensagens, os quatro bits de ordem inferior das nID parâmetro são usados internamente pelo Windows. Quando um aplicativo testa o valor de nID, ele deve agrupar o valor 0xFFF0 com o nID valor usando o operador bit a bit- E operador para obter o resultado correto.

Os itens de menu no menu de controle podem ser modificados com o GetSystemMenu, AppendMenu, InsertMenu, e ModifyMenu funções de membro. Aplicativos que modificam o menu de controle devem processar WM_SYSCOMMAND mensagens e qualquer WM_SYSCOMMAND mensagens não são manipuladas pelo aplicativo devem ser passadas para OnSysCommand. Quaisquer valores de comando adicionados por um aplicativo devem ser processados pelo aplicativo e não podem ser passadas para OnSysCommand.

Um aplicativo pode executar qualquer comando do sistema a qualquer momento passando um WM_SYSCOMMAND mensagem para OnSysCommand.

Pressionamentos de tecla aceleradora (atalho) definidas selecionar itens de menu de controle são traduzidos em OnSysCommand chamadas; todos os Outros acelerador pressionamentos de tecla são traduzidos em WM_COMMAND mensagens.

Observação:
Este memb ER função é chamada pela estrutura para permitir que seu aplicativo manipular uma mensagem do Windows.Os parâmetros passados para sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi recebida.Se você telefonar a implementação da classe base o f dessa função, essa implementação usará os parâmetros originalmente passados com a mensagem e não os parâmetros que você fornecer para a função.

Este memb ER função é chamada pela estrutura para permitir que seu aplicativo manipular uma mensagem do Windows.Os parâmetros passados para sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi recebida.Se você telefonar a implementação da classe base o f dessa função, essa implementação usará os parâmetros originalmente passados com a mensagem e não os parâmetros que você fornecer para a função.