Macro CreateDialogA (winuser.h)

Articolo
08/27/2023

Crea una finestra di dialogo senza modalità da una risorsa modello di finestra di dialogo. La macro CreateDialog usa la funzione CreateDialogParam .

Sintassi

void CreateDialogA(
  [in, optional]  hInstance,
  [in]            lpName,
  [in, optional]  hWndParent,
  [in, optional]  lpDialogFunc
);

Parametri

[in, optional] hInstance

Tipo: HINSTANCE

Handle per il modulo che contiene il modello di finestra di dialogo. Se questo parametro è NULL, viene usato l'eseguibile corrente.

[in] lpName

Tipo: LPCTSTR

Modello della finestra di dialogo. Questo parametro è il puntatore a una stringa di caratteri con terminazione Null che specifica il nome del modello di finestra di dialogo o un valore intero che specifica l'identificatore di risorsa del modello della finestra di dialogo. Se il parametro specifica un identificatore di risorsa, la parola di ordine elevato deve essere zero e la parola in ordine basso deve contenere l'identificatore. È possibile utilizzare la macro MAKEINTRESOURCE per creare questo valore.

[in, optional] hWndParent

Tipo: HWND

Handle per la finestra proprietaria della finestra di dialogo.

[in, optional] lpDialogFunc

Tipo: DLGPROC

Puntatore alla procedura della finestra di dialogo. Per altre informazioni sulla procedura della finestra di dialogo, vedere DialogProc.

Valore restituito

nessuno

Osservazioni

La funzione CreateDialog usa la funzione CreateWindowEx per creare la finestra di dialogo. CreateDialog invia quindi un messaggio di WM_INITDIALOG (e un messaggio di WM_SETFONT se il modello specifica il DS_SETFONT o lo stile di DS_SHELLFONT ) alla routine della finestra di dialogo. La funzione visualizza la finestra di dialogo se il modello specifica lo stile WS_VISIBLE . Infine, CreateDialog restituisce l'handle di finestra alla finestra di dialogo.

Dopo la restituzione di CreateDialog , l'applicazione visualizza la finestra di dialogo ,se non è già visualizzata, usando la funzione ShowWindow . L'applicazione elimina definitivamente la finestra di dialogo usando la funzione DestroyWindow . Per supportare lo spostamento tramite tastiera e altre funzionalità della finestra di dialogo, il ciclo di messaggi per la finestra di dialogo deve chiamare la funzione IsDialogMessage .

Esempio

Per un esempio, vedere Creazione di una finestra di dialogo senza modalità.

Nota

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