GetSystemMenu

A função GetSystemMenu permite que o aplicativo acessar o menu de janela (também conhecido como o menu do sistema ou o menu de controle ) para copiar e modificar.

(HMENU GetSystemMenu HWND  hWnd, / / identificador para janela a própria janela menuBOOLpasta bRevert / / redefinir bandeira);
 

Parâmetros

hWnd
Identificador para a janela que possuirá um copiar do menu janela.
pasta bRevert
Especifica a ação a ser tomada. Se este parâmetro estiver FALSE, GetSystemMenu retorna o identificador para a copiar do menu janela atualmente em uso. A copiar é inicialmente idêntica ao menu de janela , mas ele pode ser modificado.

Se este parâmetro estiver TRUE, GetSystemMenu redefine o menu janela para o estado padrão. O menu janela anterior, se houver, é destruído.

Retornar valores

Se a pasta bRevert parâmetro é FALSE, o valor de retorno é o identificador para um copiar do menu janela . Se a pasta bRevert parâmetro é TRUE, o valor de retorno é NULL.

Observações

Qualquer janela que não usa a função GetSystemMenu para fazer sua própria Copiar do menu janela recebe o menu padrão janela.

O menu janela inicialmente contém itens com diferentes valores de identificador, como SC_CLOSE, SC_MOVE e SC_SIZE.

Itens de menu no menu janela enviam mensagens WM_SYSCOMMAND.

Todos os itens de menu predefinidos janela têm números de identificador maiores que 0xF000. Se um aplicativo adicionar comandos ao menu de janela , ele deve usar números de identificador menor que 0xF000.

O sistema automaticamente grays itens no menu padrão janela , dependendo da situação. O aplicativo pode executar sua própria verificação ou grisalhos, respondendo à mensagem de WM_INITMENU é enviada antes de qualquer menu é exibido.

Windows CE: Windows CE não oferece suporte a um menu de sistema, mas GetSystemMenu é implementado como uma macro para manter a compatibilidade com o código existente. Você pode usar o identificador de menu retornado por essa macro para desabilitar a caixa Fechar da mesma forma que faria em uma plataforma de desktop de Windows. Não há nenhum outro uso para o valor de retorno em Windows CE. A pasta brevert parâmetro é ignorado. Use o código a seguir para desativar o botão Fechar

 EnableMenuItem (GetSystemMenu (hwnd, FALSE), SC_CLOSE, MF_BYCOMMAND | MF_GRAYED);

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de menus, funções de Menu, GetMenu, WM_INITMENU, WM_SYSCOMMAND

Index