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
| 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] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-menu-l1-1-0 (introduzido no Windows 8) |
Confira também
Conceitual
Referência