Compartilhar via


Função ShowWindow (winuser.h)

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)

Confira também

AnimateWindow

Conceitual

CreateProcess

Createwindow

Outros recursos

Referência

STARTUPINFO

ShowOwnedPopups

ShowWindowAsync

WinMain

Windows