Compartilhar via


CWnd::OnSysCommand

A estrutura chama essa função de membro quando o usuário seleciona um comando de menu de controle, ou quando o usuário seleciona maximizar botões ou minimizar.

afx_msg void OnSysCommand( 
   UINT nID, 
   LPARAM lParam  
);

Parâmetros

  • nID
    Especifica o tipo de comando do sistema aplicativo. Este parâmetro pode ser qualquer um dos seguintes valores:

    • Final deSC_CLOSE o objeto de CWnd .

    • SC_HOTKEY ativa o objeto de CWnd associado com a tecla de acesso aplicativo especificada. A palavra de ordem baixa de lParam identificam HWND da janela para ativar.

    • Rolagem deSC_HSCROLL horizontalmente.

    • SC_KEYMENU recupera um menu com um pressionamento de tecla.

    • SC_MAXIMIZE (ou) maximizar SC_ZOOMo objeto de CWnd .

    • SC_MINIMIZE (ou) SC_ICONminimizar o objeto de CWnd .

    • SC_MOUSEMENU recupera um menu com um clique do mouse.

    • Mudança deSC_MOVE o objeto de CWnd .

    • Mudança deSC_NEXTWINDOW para a próxima janela.

    • Mudança deSC_PREVWINDOW a janela anterior.

    • A janela de minimizar deSC_RESTORE posição e o tamanho normal.

    • SC_SCREENSAVE executa o aplicativo de tela- poupança especificado na seção [boot] do arquivo SYSTEM.INI.

    • Tamanho deSC_SIZE o objeto de CWnd .

    • SC_TASKLIST executar ou ativa o aplicativo do gerenciador de tarefas do windows.

    • Rolagem deSC_VSCROLL verticalmente.

  • lParam
    Se um comando do menu é escolhido com o mouse, lParam contém as coordenadas do cursor. A palavra de ordem baixa contêm a coordenada x, e a palavra de alta-ordem contêm a coordenada y. Se não este parâmetro não é usado.

    • SC_HOTKEY a janela ativa associada com a tecla de acesso aplicativo especificada. A palavra de ordem baixa de lParam identificam a janela para ativar.

    • SC_SCREENSAVE executa o aplicativo de tela- salvar especificado na seção da área de trabalho do painel de controle.

Comentários

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

Em mensagens de WM_SYSCOMMAND , os quatro bit de ordem baixa do parâmetro de nID são usados internamente pelo windows. Quando um aplicativo testar o valor de nID, deve combinar o valor 0xFFF0 com o valor de nID usando a bit de bits) pelo operador para obter o resultado correto.

Os itens de menu em um menu de controle podem ser alterados com GetSystemMenu, AppendMenu, InsertMenu, e funções de membro de ModifyMenu . Os aplicativos que alteram o menu de controle devem processar mensagens de WM_SYSCOMMAND , e todas as mensagens de WM_SYSCOMMAND não tratadas pelo aplicativo devem ser passados a OnSysCommand. Todos os valores de comando adicionados por um aplicativo devem ser processada pelo aplicativo e não podem ser passados para OnSysCommand.

Um aplicativo pode realizar qualquer comando do sistema a qualquer momento passando uma mensagem de WM_SYSCOMMAND a OnSysCommand.

Os pressionamentos de teclas de acelerador (atalho) que são definidos para selecionar itens de menu de controle são traduzidas em chamadas de OnSysCommand ; todos pressionamentos de teclas restantes de aceleração são traduzidas em mensagens de WM_COMMAND.

Dica

Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipule uma mensagem do windows.Parâmetros passados à sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi colocada.Se você chamar a implementação da classe base de essa função, essa implementação usará parâmetros passados originalmente com a mensagem e não os parâmetros que você fornece para a função.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

WM_SYSCOMMAND