Função GetSystemMenu (winuser.h)

Permite que o aplicativo acesse o menu da janela (também conhecido como menu do sistema ou menu de controle) para copiar e modificar.

Sintaxe

HMENU GetSystemMenu(
  [in] HWND hWnd,
  [in] BOOL bRevert
);

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela que terá uma cópia do menu da janela.

[in] bRevert

Tipo: BOOL

A ação a ser tomada. Se esse parâmetro for FALSE, GetSystemMenu retornará um identificador para a cópia do menu da janela atualmente em uso. A cópia é inicialmente idêntica ao menu da janela, mas pode ser modificada. Se esse parâmetro for TRUE, GetSystemMenu redefinirá o menu da janela de volta para o estado padrão. O menu da janela anterior, se houver, é destruído.

Retornar valor

Tipo: HMENU

Se o parâmetro bRevert for FALSE, o valor retornado será um identificador para uma cópia do menu da janela. Se o parâmetro bRevert for TRUE, o valor retornado será NULL.

Comentários

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

Inicialmente, o menu de janela contém itens com vários valores de identificador, como SC_CLOSE, SC_MOVE e SC_SIZE.

Os itens de menu no menu da janela enviam WM_SYSCOMMAND mensagens.

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

O sistema esmaeça automaticamente os itens no menu da janela padrão, dependendo da situação. O aplicativo pode executar sua própria verificação ou cinza respondendo à mensagem de WM_INITMENU enviada antes que qualquer menu seja exibido.

Requisitos

Confira também

Conceitual

GetMenu

InsertMenuItem

Menus

Referência

Setmenuiteminfo

WM_INITMENU

WM_SYSCOMMAND