Funzione CreateMDIWindowA (winuser.h)

Articolo
03/13/2024

Crea una finestra figlio dell'interfaccia a più documenti.Create a multiple-document interface (MDI).

Sintassi

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
);

Parametri

[in] lpClassName

Tipo: LPCTSTR

Classe di finestra della finestra figlio MDI. Il nome della classe deve essere stato registrato da una chiamata alla funzione RegisterClassEx .

[in] lpWindowName

Tipo: LPCTSTR

Nome della finestra. Il sistema visualizza il nome nella barra del titolo della finestra figlio.

[in] dwStyle

Tipo: DWORD

Stile della finestra figlio MDI. Se la finestra client MDI viene creata con lo stile della finestra MDIS_ALLCHILDSTYLES , questo parametro può essere qualsiasi combinazione degli stili della finestra elencati nella pagina Stili finestra. In caso contrario, questo parametro è limitato a uno o più dei valori seguenti.

Valore	Significato
WS_MINIMIZE 0x20000000L	Crea una finestra figlio MDI inizialmente ridotta a icona.
WS_MAXIMIZE 0x0100000L	Crea una finestra figlio MDI inizialmente ingrandita.
WS_HSCROLL 0x0010000L	Crea una finestra figlio MDI con una barra di scorrimento orizzontale.
WS_VSCROLL 0x0020000L	Crea una finestra figlio MDI con una barra di scorrimento verticale.

[in] X

Tipo: int

Posizione orizzontale iniziale, nelle coordinate client, della finestra figlio MDI. Se questo parametro è CW_USEDEFAULT ((int)0x80000000), la finestra figlio MDI viene assegnata alla posizione orizzontale predefinita.

[in] Y

Tipo: int

Posizione verticale iniziale, nelle coordinate client, della finestra figlio MDI. Se questo parametro è CW_USEDEFAULT, la finestra figlio MDI viene assegnata alla posizione verticale predefinita.

[in] nWidth

Tipo: int

Larghezza iniziale, nelle unità di dispositivo, della finestra figlio MDI. Se questo parametro è CW_USEDEFAULT, viene assegnata la larghezza predefinita della finestra figlio MDI.

[in] nHeight

Tipo: int

Altezza iniziale, in unità di dispositivo, della finestra figlio MDI. Se questo parametro è impostato su CW_USEDEFAULT, la finestra figlio MDI viene assegnata l'altezza predefinita.

[in, optional] hWndParent

Tipo: HWND

Handle per la finestra client MDI che sarà l'elemento padre della nuova finestra figlio MDI.

[in, optional] hInstance

Tipo: HINSTANCE

Handle per l'istanza dell'applicazione che crea la finestra figlio MDI.

[in] lParam

Tipo: LPARAM

Valore definito dall'applicazione.

Valore restituito

Tipo: HWND

Se la funzione ha esito positivo, il valore restituito è l'handle della finestra creata.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Nota

L'intestazione winuser.h definisce CreateMDIWindow come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll