Funzione CreateMDIWindowW (winuser.h)

Articolo
03/04/2024

Crea una finestra figlio MDI (Multiple-Document Interface).

Sintassi

HWND CreateMDIWindowW(
  [in]           LPCWSTR   lpClassName,
  [in]           LPCWSTR   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 del 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 ridotta inizialmente a icona.
WS_MAXIMIZE 0x01000000L	Crea una finestra figlio MDI ingrandita inizialmente.
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), alla finestra figlio MDI viene assegnata la posizione orizzontale predefinita.

[in] Y

Tipo: int

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

[in] nWidth

Tipo: int

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

[in] nHeight

Tipo: int

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

[in, optional] hWndParent

Tipo: HWND

Handle per la finestra del 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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