ShowWindow

A ShowWindow função define o estado de apresentação da janela especificada.

 BOOL ShowWindow (  HWND  hWnd, / / identificador para janelaintnCmdShow / / Mostrar estado de janela);

Parâmetros

hWnd
Identificador para a janela.
nCmdShow
Especifica como a janela deve ser mostrado. Este parâmetro é ignorado na primeira vez que um aplicativo chama ShowWindow, se o programa que lançou o aplicativo fornece um estrutura STARTUPINFO . Caso contrário, a primeira vez que ShowWindow é chamado, o valor deve ser o valor obtido pelo WinMain função no seu nCmdShow parâmetro. Em chamadas subseqüentes, este parâmetro pode ser uma dos seguinte valores
Valor Significado
SW_FORCEMINIMIZE Windows NT 5.0 e posterior: Minimiza uma janela, mesmo se o segmento que possui a janela estiver congelado. Este sinalizador só deve ser usado quando minimizar janelas de um thread diferente.
SW_HIDE Oculta a janela e ativa outra janela.
SW_MAXIMIZE Maximiza a janela especificada.
SW_MINIMIZE Minimiza a janela especificada e ativa a próxima janela de nível superior na ordem z.
SW_RESTORE Ativa e exibe a janela. Se a janela está minimizada ou maximizada, o sistema restaura-la para seu tamanho e posição originais. Um aplicativo deve especificar este Sinalizar ao restaurar uma janela minimizada.
SW_SHOW Ativa a janela e exibe-o em seu tamanho atual e a posição.
SW_SHOWDEFAULT Define o estado apresentação baseado na bandeira SW_ especificada no estrutura STARTUPINFO passado para o CreateProcess função pelo programa que iniciou o aplicativo.
SW_SHOWMAXIMIZED Ativa a janela e exibe-lo como uma janela maximizada.
SW_SHOWMINIMIZED Ativa a janela e exibe-lo como uma janela minimizada.
SW_SHOWMINNOACTIVE Exibe a janela como uma janela minimizada. A janela ativa permanece ativa.
SW_SHOWNA Exibe a janela em seu estado atual. A janela ativa permanece ativa.
SW_SHOWNOACTIVATE Exibe uma janela em seu tamanho e posição mais recentes. A janela ativa permanece ativa.
SW_SHOWNORMAL Ativa e exibe uma janela. Se a janela está minimizada ou maximizada, o sistema restaura-la para seu tamanho e posição originais. Um aplicativo deve especificar esse sinalizador quando a exibição da janela pela primeira vez.

Retornar valores

Se a janela foi anteriormente visível, o valor de retorno é diferente de zero.

Se a janela anteriormente foi oculto, o valor de retorno é zero.

Observações

A primeira vez que um aplicativo chama ShowWindow, deve usar nCmdShow parâmetro o WinMain função como seu nCmdShow parâmetro. Chamadas subseqüentes para ShowWindow devem usar um dos valores na lista determinada, em vez de um especificada pelo nCmdShow parâmetro da função WinMain.

Como observado na discussão do nCmdShow parâmetro, o valor de nCmdShow é ignorado na primeira chamada para ShowWindow se o programa que lançou o aplicativo especifica informações de inicialização no estrutura STARTUPINFO . Neste caso, ShowWindow usa as informações especificadas na estrutura de STARTUPINFO para mostrar a janela. Em chamadas subseqüentes, 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 desenvolvido para as seguintes situações

Windows CE: O nCmdShow parâmetro não oferece suporte os seguintes valores

SW_MAXIMIZE

SW_MINIMIZE

SW_RESTORE

SW_SHOWDEFAULT

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

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 sobre Windows, funções de janela, CreateProcess, CreateWindow, ShowOwnedPopups, STARTUPINFO, WinMain

Index