Funzione CreateWindowExA (winuser.h)

Crea una finestra sovrapposta, popup o figlio con uno stile di finestra estesa; in caso contrario, questa funzione è identica alla funzione CreateWindow. Per altre informazioni sulla creazione di una finestra e per le descrizioni complete degli altri parametri di CreateWindowEx, vedere CreateWindow.

Sintassi

HWND CreateWindowExA(
  [in]           DWORD     dwExStyle,
  [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] dwExStyle

Tipo: DWORD

Stile della finestra estesa da creare. Per un elenco dei valori possibili, vedere stili di finestra estesa.

[in, optional] lpClassName

Tipo: LPCTSTR

Un nullstringa con terminazione o un atomo di classe.

Se un nullstringa con terminazione, specifica il nome della classe della finestra. Il nome della classe può essere qualsiasi nome registrato con la RegisterClass o funzione RegisterClassEx, purché il modulo che registra la classe sia anche il modulo che crea la finestra. Il nome della classe può essere anche uno qualsiasi dei nomi di della classe di sistema predefinita.

Se un atomo di classe creato da una chiamata precedente a RegisterClass o RegisterClassEx, deve essere convertito utilizzando la macro MAKEINTATOM. L'atom deve essere nella parola in ordine basso di lpClassName; la parola di ordine elevato deve essere zero.

[in, optional] lpWindowName

Tipo: LPCTSTR

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 x è 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 y è la coordinata iniziale 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 dalle coordinate x iniziali al bordo destro dello schermo; 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, il parametro nWidth e nHeight parametro è impostato 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 il parametro 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 punta 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.

Questa funzione ha in genere esito negativo per uno dei motivi seguenti:

• un valore di parametro non valido
• la classe di sistema è stata registrata da un modulo diverso
• L'hook WH_CBT è installato e restituisce un codice di errore
• se uno dei controlli nel modello di finestra di dialogo non è registrato o la relativa routine della finestra di dialogo ha esito negativo WM_CREATE o WM_NCCREATE

Osservazioni

La funzione CreateWindowEx invia messaggi WM_NCCREATE, WM_NCCALCSIZEe WM_CREATE alla finestra creata.

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.

È possibile specificare le classi di controllo predefinite seguenti nel parametro lpClassName. Si notino gli stili di controllo corrispondenti che è possibile usare nel parametro dwStyle.

Il valore WS_EX_NOACTIVATE per dwExStyle impedisce l'attivazione in primo piano dal sistema. Per impedire l'attivazione della coda quando l'utente fa clic sulla finestra, è necessario elaborare il messaggio di WM_MOUSEACTIVATE in modo appropriato. Per portare la finestra in primo piano o attivarla a livello di codice, usare SetForegroundWindow o SetActiveWindow. La restituzione di FALSE a WM_NCACTIVATE impedisce alla finestra di perdere l'attivazione della coda. Tuttavia, il valore restituito viene ignorato in fase di attivazione.

Con WS_EX_COMPOSITED impostato, tutti i discendenti di una finestra ottengono l'ordine di disegno da basso a alto usando il doppio buffer. L'ordine di disegno da basso a alto consente a una finestra discendente di avere effetti di traslucidenza (alfa) e trasparenza (chiave di colore), ma solo se la finestra discendente ha anche il WS_EX_TRANSPARENT bit impostato. Il doppio buffering consente di disegnare la finestra e i relativi discendenti senza sfarfallio.

Esempio

Il codice di esempio seguente illustra l'uso di CreateWindowExA.

BOOL Create(
        PCWSTR lpWindowName,
        DWORD dwStyle,
        DWORD dwExStyle = 0,
        int x = CW_USEDEFAULT,
        int y = CW_USEDEFAULT,
        int nWidth = CW_USEDEFAULT,
        int nHeight = CW_USEDEFAULT,
        HWND hWndParent = 0,
        HMENU hMenu = 0
        )
    {
        WNDCLASS wc = {0};

        wc.lpfnWndProc   = DERIVED_TYPE::WindowProc;
        wc.hInstance     = GetModuleHandle(NULL);
        wc.lpszClassName = ClassName();

        RegisterClass(&wc);

        m_hwnd = CreateWindowEx(
            dwExStyle, ClassName(), lpWindowName, dwStyle, x, y,
            nWidth, nHeight, hWndParent, hMenu, GetModuleHandle(NULL), this
            );

        return (m_hwnd ? TRUE : FALSE);
    }

Fabbisogno

Vedere anche

informazioni sull'interfaccia a documenti multipli

CLIENTCREATESTRUCT

CREATESTRUCT

concettuale

CreateWindow

DestroyWindow

EnableWindow

altre risorse

riferimento

RegisterClass

RegisterClassEx

SetActiveWindow

SetForegroundWindow

SetWindowLong

SetWindowPos

ShowWindow

WM_CREATE

WM_NCCALCSIZE

WM_NCCREATE

WM_PAINT

WM_PARENTNOTIFY

Windows