winuser.h


ShowWindow

Esta función especifica cómo se mostrará la ventana.

Sintaxis

BOOL ShowWindow( 
   HWND hwnd, // manipulador de ventana
   int nCmdShow // modo de visualización de ventana
); 

Parámetros:

hwnd: manipulador de ventana. Identifica la ventana.

nCmdShow: modo en que se mostrará la ventana. Puede tomar uno de los siguientes valores.

Valor de retorno

Si la ventana era visible previamente, el valor de retorno es TRUE. Si la ventana estaba oculta, el valor de retorno es FALSE.

Observaciones

Esta función debe ser llamada sólo una vez por programa con el parámetro nCmdShow de WinMain. Las siguientes llamadas deben usar uno de los valores de la tabla anterior.

Una aplicación debe llamar a ShowWindow con el parámetro nCmdShow para usar la información de arranque de aplicaciones que afecta a cómo se muestran las ventanas. Por ejemplo, si el Administrador de Programas especifica que las aplicaciones deben arrancar con su ventana principal minimizada. Las aplicaciones basadas en Win32 también usan esta información cuando se llama a ShowWindow por primera vez con el valor SW_SHOW en nCmdShow. Este comportamiento está diseñado para las siguientes situaciones:

Aplicaciones que crean su ventana principal llamando a CreateWindow con el flag WS_VISIBLE.

Aplicaciones que crean su ventana principal llamando a CreateWindow sin el flag WS_VISIBLE, y después llaman a ShowWindow con este flag activado para hacerla visible.