Função ShowWindow (winuser.h)

Artigo
06/08/2023

Define o estado de exibição da janela especificada.

Sintaxe

BOOL ShowWindow(
  [in] HWND hWnd,
  [in] int  nCmdShow
);

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela.

[in] nCmdShow

Tipo: int

Controla como a janela deve ser mostrada. Esse parâmetro será ignorado na primeira vez que um aplicativo chamar ShowWindow, se o programa que iniciou o aplicativo fornecer uma estrutura STARTUPINFO . Caso contrário, na primeira vez que ShowWindow for chamado, o valor deverá ser o valor obtido pela função WinMain em seu parâmetro nCmdShow . Em chamadas subsequentes, esse parâmetro pode ser um dos valores a seguir.

Valor	Significado
SW_HIDE 0	Oculta a janela e ativa outra janela.
SW_SHOWNORMAL SW_NORMAL 1	Ativa e exibe uma janela. Se a janela for minimizada, maximizada ou organizada, o sistema a restaurará para seu tamanho e posição originais. Um aplicativo deve especificar esse sinalizador ao exibir a janela pela primeira vez.
SW_SHOWMINIMIZED 2	Ativa a janela e a exibe como uma janela minimizada.
SW_SHOWMAXIMIZED SW_MAXIMIZE 3	Ativa a janela e a exibe como uma janela maximizada.
SW_SHOWNOACTIVATE 4	Exibe uma janela em seu tamanho e posição mais recentes. Esse valor é semelhante a SW_SHOWNORMAL, exceto que a janela não está ativada.
SW_SHOW 5	Ativa a janela e a exibe em seu tamanho e posição atuais.
SW_MINIMIZE 6	Minimiza a janela especificada e ativa a próxima janela de nível superior na ordem Z.
SW_SHOWMINNOACTIVE 7	Exibe a janela como uma janela minimizada. Esse valor é semelhante a SW_SHOWMINIMIZED, exceto que a janela não está ativada.
SW_SHOWNA 8	Exibe a janela em seu tamanho e posição atuais. Esse valor é semelhante a SW_SHOW, exceto que a janela não está ativada.
SW_RESTORE 9	Ativa e exibe a janela. Se a janela for minimizada, maximizada ou organizada, o sistema a restaurará para seu tamanho e posição originais. Um aplicativo deve especificar esse sinalizador ao restaurar uma janela minimizada.
SW_SHOWDEFAULT 10	Define o estado de exibição com base no valor SW_ especificado na estrutura STARTUPINFO passada para a função CreateProcess pelo programa que iniciou o aplicativo.
SW_FORCEMINIMIZE 11	Minimiza uma janela, mesmo que o thread que possui a janela não esteja respondendo. Esse sinalizador só deve ser usado ao minimizar janelas de um thread diferente.

Valor retornado

Tipo: BOOL

Se a janela estiver visível anteriormente, o valor retornado será diferente de zero.

Se a janela foi ocultada anteriormente, o valor retornado será zero.

Comentários

Para executar determinados efeitos especiais ao mostrar ou ocultar uma janela, use AnimateWindow.

Na primeira vez que um aplicativo chama ShowWindow, ele deve usar o parâmetro nCmdShow da função WinMain como seu parâmetro nCmdShow. As chamadas subsequentes para ShowWindow devem usar um dos valores na lista fornecida, em vez do especificado pelo parâmetro nCmdShow da função WinMain.

Conforme observado na discussão do parâmetro nCmdShow , o valor nCmdShow será ignorado na primeira chamada para ShowWindow se o programa que iniciou o aplicativo especificar informações de inicialização na estrutura. Nesse caso, ShowWindow usa as informações especificadas na estrutura STARTUPINFO para mostrar a janela. Nas chamadas subsequentes, o aplicativo deve chamar ShowWindow com nCmdShow definido como SW_SHOWDEFAULT para usar as informações de inicialização fornecidas pelo programa que iniciou o aplicativo. Esse comportamento foi projetado para as seguintes situações:

Os aplicativos criam sua janela main chamando CreateWindow com o sinalizador WS_VISIBLE definido.
Os aplicativos criam sua janela main chamando CreateWindow com o sinalizador WS_VISIBLE limpo e, posteriormente, chamam ShowWindow com o sinalizador SW_SHOW definido para torná-lo visível.

Exemplos

Para obter um exemplo, consulte Criando uma janela principal.

Requisitos


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-window-l1-1-0 (introduzido em Windows 8)