Funzione CreateMDIWindowA (winuser.h)

Articolo
11/20/2024

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

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 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 inizialmente ridotta a icona.
WS_MAXIMIZE 0x01000000L	Crea una finestra figlio MDI ingrandita inizialmente.
WS_HSCROLL 0x00100000L	Crea una finestra figlio MDI con una barra di scorrimento orizzontale.
WS_VSCROLL 0x00200000L	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 per la finestra creata.

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

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll