Función ShowWindow (winuser.h)

Artículo
06/06/2023

Establece el estado de presentación de la ventana especificada.

Sintaxis

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

Parámetros

[in] hWnd

Tipo: HWND

Un identificador de la ventana.

[in] nCmdShow

Tipo: int

Controla cómo se va a mostrar la ventana. Este parámetro se omite la primera vez que una aplicación llama a ShowWindow, si el programa que inició la aplicación proporciona una estructura STARTUPINFO . De lo contrario, se llama a la primera vez que se llama a ShowWindow , el valor debe ser el valor obtenido por la función WinMain en su parámetro nCmdShow . En llamadas posteriores, este parámetro puede ser uno de los siguientes valores.

Valor	Significado
SW_HIDE 0	Oculta la ventana y activa otra ventana.
SW_SHOWNORMAL SW_NORMAL 1	Activa y muestra una ventana. Si la ventana está minimizada, maximizada o organizada, el sistema lo restaura a su tamaño y posición originales. Una aplicación debe especificar esta marca al mostrar la ventana por primera vez.
SW_SHOWMINIMIZED 2	Activa la ventana y la muestra como una ventana minimizada.
SW_SHOWMAXIMIZED SW_MAXIMIZE 3	Activa la ventana y la muestra como una ventana maximizada.
SW_SHOWNOACTIVATE 4	Muestra una ventana en su tamaño y posición más recientes. Este valor es similar a SW_SHOWNORMAL, salvo que la ventana no está activada.
SW_SHOW 5	Activa la ventana y la muestra en su tamaño y posición actuales.
SW_MINIMIZE 6	Minimiza la ventana especificada y activa la siguiente ventana de nivel superior en el orden Z.
SW_SHOWMINNOACTIVE 7	Muestra la ventana como una ventana minimizada. Este valor es similar a SW_SHOWMINIMIZED, excepto que la ventana no está activada.
SW_SHOWNA 8	Muestra la ventana en su tamaño y posición actuales. Este valor es similar a SW_SHOW, salvo que la ventana no está activada.
SW_RESTORE 9	Activa y muestra la ventana. Si la ventana está minimizada, maximizada o organizada, el sistema lo restaura a su tamaño y posición originales. Una aplicación debe especificar esta marca al restaurar una ventana minimizada.
SW_SHOWDEFAULT 10	Establece el estado show basado en el valor de SW_ especificado en la estructura STARTUPINFO pasada a la función CreateProcess por el programa que inició la aplicación.
SW_FORCEMINIMIZE 11	Minimiza una ventana, incluso si el subproceso que posee la ventana no responde. Esta marca solo debe usarse al minimizar ventanas de un subproceso diferente.

Valor devuelto

Tipo: BOOL

Si la ventana estaba visible anteriormente, el valor devuelto es distinto de cero.

Si la ventana estaba oculta anteriormente, el valor devuelto es cero.

Comentarios

Para realizar ciertos efectos especiales al mostrar u ocultar una ventana, use AnimateWindow.

La primera vez que una aplicación llama a ShowWindow, debe usar el parámetro nCmdShow de la función WinMain como su parámetro nCmdShow. Las llamadas posteriores a ShowWindow deben usar uno de los valores de la lista especificada, en lugar del especificado por el parámetro nCmdShow de la función WinMain.

Como se indicó en la explicación del parámetro nCmdShow , el valor nCmdShow se omite en la primera llamada a ShowWindow si el programa que inició la aplicación especifica información de inicio en la estructura. En este caso, ShowWindow usa la información especificada en la estructura STARTUPINFO para mostrar la ventana. En las llamadas posteriores, la aplicación debe llamar a ShowWindow con nCmdShow establecido en SW_SHOWDEFAULT para usar la información de inicio proporcionada por el programa que inició la aplicación. Este comportamiento está diseñado para las siguientes situaciones:

Las aplicaciones crean su ventana principal llamando a CreateWindow con la marca WS_VISIBLE establecida.
Las aplicaciones crean su ventana principal llamando a CreateWindow con la marca WS_VISIBLE desactivada y, posteriormente, llama a ShowWindow con la marca SW_SHOW establecida para que sea visible.

Ejemplos

Para obtener un ejemplo, vea Crear una ventana principal.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-0 (introducido en Windows 8)