CreateMDIWindowA, fonction (winuser.h)

Article
03/04/2024

Crée une fenêtre enfant MDI (Multi-Document Interface).

Syntaxe

HWND CreateMDIWindowA(
  [in]           LPCSTR    lpClassName,
  [in]           LPCSTR    lpWindowName,
  [in]           DWORD     dwStyle,
  [in]           int       X,
  [in]           int       Y,
  [in]           int       nWidth,
  [in]           int       nHeight,
  [in, optional] HWND      hWndParent,
  [in, optional] HINSTANCE hInstance,
  [in]           LPARAM    lParam
);

Paramètres

[in] lpClassName

Type : LPCTSTR

Classe de fenêtre de la fenêtre enfant MDI. Le nom de classe doit avoir été inscrit par un appel à la fonction RegisterClassEx .

[in] lpWindowName

Type : LPCTSTR

Nom de fenêtre. Le système affiche le nom dans la barre de titre de la fenêtre enfant.

[in] dwStyle

Type : DWORD

Style de la fenêtre enfant MDI. Si la fenêtre cliente MDI est créée avec le style de fenêtre MDIS_ALLCHILDSTYLES , ce paramètre peut être n’importe quelle combinaison des styles de fenêtre répertoriés dans la page Styles de fenêtre . Sinon, ce paramètre est limité à une ou plusieurs des valeurs suivantes.

Valeur	Signification
WS_MINIMIZE 0x20000000L	Crée une fenêtre enfant MDI qui est initialement réduite.
WS_MAXIMIZE 0x01000000L	Crée une fenêtre enfant MDI qui est initialement agrandie.
WS_HSCROLL 0x00100000L	Crée une fenêtre enfant MDI qui a une barre de défilement horizontale.
WS_VSCROLL 0x00200000L	Crée une fenêtre enfant MDI qui a une barre de défilement verticale.

[in] X

Type : int

Position horizontale initiale, dans les coordonnées du client, de la fenêtre enfant MDI. Si ce paramètre est CW_USEDEFAULT ((int)0x80000000), la fenêtre enfant MDI se voit attribuer la position horizontale par défaut.

[in] Y

Type : int

Position verticale initiale, dans les coordonnées du client, de la fenêtre enfant MDI. Si ce paramètre est CW_USEDEFAULT, la position verticale par défaut est attribuée à la fenêtre enfant MDI.

[in] nWidth

Type : int

Largeur initiale, en unités d’appareil, de la fenêtre enfant MDI. Si ce paramètre est CW_USEDEFAULT, la largeur par défaut est attribuée à la fenêtre enfant MDI.

[in] nHeight

Type : int

Hauteur initiale, en unités d’appareil, de la fenêtre enfant MDI. Si ce paramètre est défini sur CW_USEDEFAULT, la hauteur par défaut est attribuée à la fenêtre enfant MDI.

[in, optional] hWndParent

Type : HWND

Handle de la fenêtre du client MDI qui sera le parent de la nouvelle fenêtre enfant MDI.

[in, optional] hInstance

Type : HINSTANCE

Handle du instance de l’application qui crée la fenêtre enfant MDI.

[in] lParam

Type : LPARAM

Valeur définie par l’application.

Valeur retournée

Type : HWND

Si la fonction réussit, la valeur de retour est le handle de la fenêtre créée.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Notes

L’en-tête winuser.h définit CreateMDIWindow comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
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