CreateMDIWindowA, fonction (winuser.h)

Article
11/20/2024

Crée une fenêtre enfant mDI (multidocument 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 la 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. Dans le cas contraire, ce paramètre est limité à une ou plusieurs des valeurs suivantes.

Valeur	Signification
WS_MINIMIZE 0x200000000L	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 est affectée à 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 fenêtre enfant MDI est affectée à la position verticale par défaut.

[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 fenêtre enfant MDI est affectée à la largeur par défaut.

[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 fenêtre enfant MDI est affectée à la hauteur par défaut.

[in, optional] hWndParent

Type : HWND

Handle vers la fenêtre cliente MDI qui sera le parent de la nouvelle fenêtre enfant MDI.

[in, optional] hInstance

Type : HINSTANCE

Handle de l’instance de l’application créant la fenêtre enfant MDI.

[in] lParam

Type : LPARAM

Valeur définie par l’application.

Valeur de retour

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’erreur étendues, appelez GetLastError.

Remarques

Note

L’en-tête winuser.h définit CreateMDIWindow comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include Windows.h)
bibliothèque	User32.lib
DLL	User32.dll