ShowWindow, fonction (winuser.h)

Article
06/08/2023

Définit l’état d’affichage de la fenêtre spécifiée.

Syntaxe

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

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre.

[in] nCmdShow

Type : int

Contrôle la façon dont la fenêtre doit être affichée. Ce paramètre est ignoré la première fois qu’une application appelle ShowWindow, si le programme qui a lancé l’application fournit une structure STARTUPINFO . Sinon, la première fois que ShowWindow est appelé, la valeur doit être la valeur obtenue par la fonction WinMain dans son paramètre nCmdShow . Dans les appels suivants, ce paramètre peut être l’une des valeurs suivantes.

Valeur	Signification
SW_HIDE 0	Masque la fenêtre et active une autre fenêtre.
SW_SHOWNORMAL SW_NORMAL 1	Active et affiche une fenêtre. Si la fenêtre est réduite, agrandie ou organisée, le système la restaure à sa taille et à sa position d’origine. Une application doit spécifier cet indicateur lors de l’affichage de la fenêtre pour la première fois.
SW_SHOWMINIMIZED 2	Active la fenêtre et l’affiche en tant que fenêtre réduite.
SW_SHOWMAXIMIZED SW_MAXIMIZE 3	Active la fenêtre et l’affiche sous la forme d’une fenêtre agrandie.
SW_SHOWNOACTIVATE 4	Affiche une fenêtre dans sa taille et sa position les plus récentes. Cette valeur est similaire à SW_SHOWNORMAL, sauf que la fenêtre n’est pas activée.
SW_SHOW 5	Active la fenêtre et l’affiche dans sa taille et sa position actuelles.
SW_MINIMIZE 6	Réduit la fenêtre spécifiée et active la fenêtre de niveau supérieur suivante dans l’ordre Z.
SW_SHOWMINNOACTIVE 7	Affiche la fenêtre sous forme de fenêtre réduite. Cette valeur est similaire à SW_SHOWMINIMIZED, sauf que la fenêtre n’est pas activée.
SW_SHOWNA 8	Affiche la fenêtre dans sa taille et sa position actuelles. Cette valeur est similaire à SW_SHOW, sauf que la fenêtre n’est pas activée.
SW_RESTORE 9	Active et affiche la fenêtre. Si la fenêtre est réduite, agrandie ou organisée, le système la restaure à sa taille et à sa position d’origine. Une application doit spécifier cet indicateur lors de la restauration d’une fenêtre réduite.
SW_SHOWDEFAULT 10	Définit l’état d’affichage en fonction de la valeur SW_ spécifiée dans la structure STARTUPINFO transmise à la fonction CreateProcess par le programme qui a démarré l’application.
SW_FORCEMINIMIZE 11	Réduit une fenêtre, même si le thread propriétaire de la fenêtre ne répond pas. Cet indicateur ne doit être utilisé que lors de la réduction des fenêtres à partir d’un thread différent.

Valeur retournée

Type : BOOL

Si la fenêtre était précédemment visible, la valeur de retour est différente de zéro.

Si la fenêtre était précédemment masquée, la valeur de retour est zéro.

Notes

Pour effectuer certains effets spéciaux lors de l’affichage ou du masquage d’une fenêtre, utilisez AnimateWindow.

La première fois qu’une application appelle ShowWindow, elle doit utiliser le paramètre nCmdShow de la fonction WinMain comme paramètre nCmdShow. Les appels ultérieurs à ShowWindow doivent utiliser l’une des valeurs de la liste donnée, au lieu de celle spécifiée par le paramètre nCmdShow de la fonction WinMain.

Comme indiqué dans la discussion du paramètre nCmdShow , la valeur nCmdShow est ignorée dans le premier appel à ShowWindow si le programme qui a lancé l’application spécifie des informations de démarrage dans la structure. Dans ce cas, ShowWindow utilise les informations spécifiées dans la structure STARTUPINFO pour afficher la fenêtre. Lors des appels suivants, l’application doit appeler ShowWindow avec nCmdShow défini sur SW_SHOWDEFAULT pour utiliser les informations de démarrage fournies par le programme qui a lancé l’application. Ce comportement est conçu pour les situations suivantes :

Les applications créent leur fenêtre main en appelant CreateWindow avec l’indicateur WS_VISIBLE défini.
Les applications créent leur fenêtre main en appelant CreateWindow avec l’indicateur WS_VISIBLE effacé, puis en appelant ShowWindow avec l’indicateur SW_SHOW défini pour le rendre visible.

Exemples

Pour obtenir un exemple, consultez Création d’une fenêtre principale.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-0 (introduit dans Windows 8)