Macro CreateWindowA (winuser.h)

Articolo
07/25/2024

Crea una finestra sovrapposta, popup o figlio. Specifica la classe della finestra, il titolo della finestra, lo stile della finestra e ,facoltativamente, la posizione iniziale e le dimensioni della finestra. La funzione specifica anche il proprietario o l'elemento padre della finestra, se presente, e il menu della finestra.

Per usare stili di finestra estesi oltre agli stili supportati da CreateWindow, usare la funzione CreateWindowEx .

Sintassi

HWND CreateWindowA(
  [in, optional] LPCSTR    lpClassName,
  [in, optional] LPCSTR    lpWindowName,
  [in]           DWORD     dwStyle,
  [in]           int       x,
  [in]           int       y,
  [in]           int       nWidth,
  [in]           int       nHeight,
  [in, optional] HWND      hWndParent,
  [in, optional] HMENU     hMenu,
  [in, optional] HINSTANCE hInstance,
  [in, optional] LPVOID    lpParam
);

Parametri

[in, optional] lpClassName

Tipo: LPCSTR

Oggetto null-terminated string o un atom di classe creato da una chiamata precedente alla funzione RegisterClass o RegisterClassEx. L'atomo deve essere nella parola in ordine basso di lpClassName; la parola di ordine elevato deve essere zero. Se lpClassName è una stringa, specifica il nome della classe della finestra. Il nome della classe può essere qualsiasi nome registrato con RegisterClass o RegisterClassEx, purché il modulo che registra la classe sia anche il modulo che crea la finestra. Il nome della classe può anche essere uno qualsiasi dei nomi predefiniti della classe di sistema. Per un elenco dei nomi delle classi di sistema, vedere la sezione Osservazioni.

[in, optional] lpWindowName

Tipo: LPCSTR

Nome della finestra. Se lo stile della finestra specifica una barra del titolo, il titolo della finestra a cui punta lpWindowName viene visualizzato nella barra del titolo. Quando si usa CreateWindow per creare controlli, ad esempio pulsanti, caselle di controllo e controlli statici, usare lpWindowName per specificare il testo del controllo. Quando si crea un controllo statico con lo stile SS_ICON, usare lpWindowName per specificare il nome o l'identificatore dell'icona. Per specificare un identificatore, usare la sintassi "#num".

[in] dwStyle

Tipo: DWORD

Stile della finestra da creare. Questo parametro può essere una combinazione dei valori dello stile finestra, oltre agli stili di controllo indicati nella sezione Osservazioni.

[in] x

Tipo: int

Posizione orizzontale iniziale della finestra. Per una finestra popup o sovrapposta, il parametro x è la coordinata x iniziale dell'angolo superiore sinistro della finestra, nelle coordinate dello schermo. Per una finestra figlio, x è la coordinata x dell'angolo superiore sinistro della finestra rispetto all'angolo superiore sinistro dell'area client della finestra padre. Se questo parametro è impostato su CW_USEDEFAULT, il sistema seleziona la posizione predefinita per l'angolo superiore sinistro della finestra e ignora il parametro y. CW_USEDEFAULT è valido solo per le finestre sovrapposte; se viene specificato per una finestra popup o figlio, i parametri x e y sono impostati su zero.

[in] y

Tipo: int

Posizione verticale iniziale della finestra. Per una finestra popup o sovrapposta, il parametro y è la coordinata iniziale y dell'angolo superiore sinistro della finestra, nelle coordinate dello schermo. Per una finestra figlio, y è la coordinata iniziale y dell'angolo superiore sinistro della finestra figlio rispetto all'angolo superiore sinistro dell'area client della finestra padre. Per una casella di riepilogo, è la coordinata iniziale y dell'angolo superiore sinistro dell'area client della casella di riepilogo rispetto all'angolo superiore sinistro dell'area client della finestra padre.

Se viene creata una finestra sovrapposta con il bit di stile WS_VISIBLE impostato e il parametro x viene impostato su CW_USEDEFAULT, il parametro y determina la modalità di visualizzazione della finestra. Se il parametro y è CW_USEDEFAULT, il gestore finestre chiama ShowWindow con il flag SW_SHOW dopo la creazione della finestra. Se il parametro y è un altro valore, gestione finestre chiama ShowWindow con tale valore come parametro nCmdShow.

[in] nWidth

Tipo: int

Larghezza, in unità di dispositivo, della finestra. Per le finestre sovrapposte, nWidth è la larghezza della finestra, nelle coordinate dello schermo o CW_USEDEFAULT. Se nWidth è CW_USEDEFAULT, il sistema seleziona una larghezza e un'altezza predefiniti per la finestra; la larghezza predefinita si estende dalla coordinata x iniziale al bordo destro dello schermo e l'altezza predefinita si estende dalla coordinata y iniziale alla parte superiore dell'area icona. CW_USEDEFAULT è valido solo per le finestre sovrapposte; se CW_USEDEFAULT viene specificato per una finestra popup o figlio, nWidth e nHeight sono impostati su zero.

[in] nHeight

Tipo: int

Altezza, in unità di dispositivo, della finestra. Per le finestre sovrapposte, nHeight è l'altezza della finestra, nelle coordinate dello schermo. Se nWidth è impostato su CW_USEDEFAULT, il sistema ignora nHeight.

[in, optional] hWndParent

Tipo: HWND

Handle per la finestra padre o proprietaria della finestra da creare. Per creare una finestra figlio o una finestra di proprietà, specificare un handle di finestra valido. Questo parametro è facoltativo per le finestre popup.

Per creare una finestra di sola messaggio, specificare HWND_MESSAGE o un handle a una finestra di sola messaggio esistente.

[in, optional] hMenu

Tipo: HMENU

Handle di un menu o specifica un identificatore di finestra figlio a seconda dello stile della finestra. Per una finestra sovrapposta o popup, hMenu identifica il menu da usare con la finestra; può essere NULL se è necessario usare il menu della classe. Per una finestra figlio, hMenu specifica l'identificatore della finestra figlio, un valore intero utilizzato da un controllo della finestra di dialogo per notificare all'elemento padre gli eventi. L'applicazione determina l'identificatore della finestra figlio; deve essere univoco per tutte le finestre figlio con la stessa finestra padre.

[in, optional] hInstance

Tipo: HINSTANCE

Handle per l'istanza del modulo da associare alla finestra.

[in, optional] lpParam

Tipo: LPVOID

Puntatore a un valore da passare alla finestra tramite la struttura CREATESTRUCT (lpCreateParams membro) a cui fa riferimento il parametro lParam del messaggio di WM_CREATE. Questo messaggio viene inviato alla finestra creata da questa funzione prima che venga restituito.

Se un'applicazione chiama CreateWindow per creare una finestra client MDI, lpParam deve puntare a una struttura CLIENTCREATESTRUCT. Se una finestra del client MDI chiama CreateWindow per creare una finestra figlio MDI, lpParam deve puntare a una struttura MDICREATESTRUCT . lpParam può essere NULL se non sono necessari dati aggiuntivi.

Valore restituito

Tipo: HWND

Se la funzione ha esito positivo, il valore restituito è un handle per la nuova finestra.

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

Osservazioni

Prima di tornare, CreateWindow invia un messaggio WM_CREATE alla routine della finestra. Per le finestre sovrapposte, popup e figlio, CreateWindow invia messaggi WM_CREATE, WM_GETMINMAXINFOe WM_NCCREATE alla finestra. Il parametro lParam del messaggio di WM_CREATE contiene un puntatore a una struttura CREATESTRUCT. Se viene specificato lo stile WS_VISIBLE, CreateWindow invia alla finestra tutti i messaggi necessari per attivare e visualizzare la finestra.

Se la finestra creata è una finestra figlio, la posizione predefinita si trova nella parte inferiore dell'ordine Z. Se la finestra creata è una finestra di primo livello, la posizione predefinita si trova all'inizio dell'ordine Z (ma sotto tutte le finestre più in alto a meno che la finestra creata non si trova all'inizio).

Per informazioni sul controllo della visualizzazione di un pulsante per la finestra creata, vedere Gestione dei pulsanti della barra delle applicazioni.

Per informazioni sulla rimozione di una finestra, vedere la funzione DestroyWindow.

Le classi di sistema predefinite seguenti possono essere specificate nel parametro lpClassName. Si notino gli stili di controllo corrispondenti che è possibile usare nel parametro dwStyle.

Classe di sistema	Significato
BUTTON	Definisce una piccola finestra figlio rettangolare che rappresenta un pulsante su cui l'utente può fare clic per attivarlo o disattivarlo. I controlli pulsante possono essere usati da soli o in gruppi e possono essere etichettati o visualizzati senza testo. I controlli pulsante cambiano in genere l'aspetto quando l'utente fa clic su di essi. Per altre informazioni, vedere Pulsanti Per una tabella degli stili dei pulsanti che è possibile specificare nel parametro dwStyle , vedere Button Styles.
COMBOBOX	Definisce un controllo costituito da una casella di riepilogo e da un campo di selezione simile a un controllo di modifica. Quando si usa questo stile, un'applicazione deve visualizzare sempre la casella di riepilogo o abilitare una casella di riepilogo a discesa. Se la casella di riepilogo è visibile, digitando i caratteri nel campo di selezione viene evidenziata la prima voce della casella di riepilogo corrispondente ai caratteri digitati. Al contrario, la selezione di un elemento nella casella di riepilogo visualizza il testo selezionato nel campo di selezione. Per altre informazioni, vedere caselle combinate. Per una tabella degli stili delle caselle combinate è possibile specificare nel parametro dwStyle, vedere stili casella combinata.
MODIFICA	Definisce una finestra figlio rettangolare in cui l'utente può digitare testo dalla tastiera. L'utente seleziona il controllo e assegna lo stato attivo della tastiera facendo clic su di esso o spostandolo su di esso premendo TAB. L'utente può digitare testo quando il controllo di modifica visualizza un cursore lampeggiante; utilizzare il mouse per spostare il cursore, selezionare i caratteri da sostituire o posizionare il cursore per l'inserimento di caratteri; oppure usare la chiave BACKSPACE per eliminare i caratteri. Per altre informazioni, vedere Modificare i controlli. Per una tabella degli stili di controllo di modifica che è possibile specificare nel parametro dwStyle, vedere Modifica stili di controllo.
LISTBOX	Definisce un elenco di stringhe di caratteri. Specificare questo controllo ogni volta che un'applicazione deve presentare un elenco di nomi, ad esempio nomi di file, da cui l'utente può scegliere. L'utente può selezionare una stringa facendo clic su di essa. Una stringa selezionata è evidenziata e un messaggio di notifica viene passato alla finestra padre. Per altre informazioni, vedere Caselle di riepilogo. Per una tabella degli stili delle caselle di riepilogo che è possibile specificare nel parametro dwStyle , vedere stili casella di riepilogo.
MDICLIENT	Designa una finestra client MDI. Questa finestra riceve messaggi che controllano le finestre figlio dell'applicazione MDI. I bit di stile consigliati sono WS_CLIPCHILDREN e WS_CHILD. Specificare gli stili WS_HSCROLL e WS_VSCROLL per creare una finestra client MDI che consente all'utente di scorrere le finestre figlio MDI nella visualizzazione. Per altre informazioni, vedere interfaccia a documenti multipli.
RichEdit	Designa un controllo Microsoft Rich Edit 1.0. Questa finestra consente all'utente di visualizzare e modificare testo con formattazione carattere e paragrafo e può includere oggetti COM (Component Object Model) incorporati. Per altre informazioni, vedere controllo Rich Edit. Per una tabella degli stili di controllo di modifica rtf che è possibile specificare nel parametro dwStyle, vedere Rich Edit Control Styles.
RICHEDIT_CLASS	Designa un controllo Microsoft Rich Edit 2.0. Questo controllo consente all'utente di visualizzare e modificare il testo con formattazione carattere e paragrafo e può includere oggetti COM incorporati. Per altre informazioni, vedere controllo Rich Edit. Per una tabella degli stili di controllo di modifica rtf che è possibile specificare nel parametro dwStyle, vedere Rich Edit Control Styles.
SCROLLBAR	Definisce un rettangolo che contiene una casella di scorrimento e ha frecce di direzione a entrambe le estremità. La barra di scorrimento invia un messaggio di notifica alla relativa finestra padre ogni volta che l'utente fa clic sul controllo. La finestra padre è responsabile dell'aggiornamento della posizione della casella di scorrimento, se necessario. Per altre informazioni, vedere barre di scorrimento. Per una tabella degli stili di controllo barra di scorrimento che è possibile specificare nel parametro dwStyle, vedere Stili di controllo barra di scorrimento.
STATIC	Designa un campo di testo semplice, una casella o un rettangolo utilizzato per etichettare, casella o separare altri controlli. I controlli statici non accettano input e non forniscono alcun output. Per altre informazioni, vedere controlli statici. Per una tabella degli stili di controllo statici che è possibile specificare nel parametro dwStyle, vedere stili di controllo statici.

CreateWindow viene implementato come chiamata alla funzione CreateWindowEx, come illustrato di seguito.

#define CreateWindowA(lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)\
CreateWindowExA(0L, lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)

#define CreateWindowW(lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)\
CreateWindowExW(0L, lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)

#ifdef UNICODE
#define CreateWindow  CreateWindowW
#else
#define CreateWindow  CreateWindowA
#endif

Esempi

Per un esempio, vedere Using Window Classes.

Nota

L'intestazione winuser.h definisce CreateWindow 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)