Funzione EndDialog (winuser.h)

Articolo
08/27/2023

Elimina una finestra di dialogo modale, causando la fine dell'elaborazione da parte del sistema per la finestra di dialogo.

Sintassi

BOOL EndDialog(
  [in] HWND    hDlg,
  [in] INT_PTR nResult
);

Parametri

[in] hDlg

Tipo: HWND

Handle della finestra di dialogo da eliminare.

[in] nResult

Tipo: INT_PTR

Valore da restituire all'applicazione dalla funzione che ha creato la finestra di dialogo.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Le finestre di dialogo create dalle funzioni DialogBox, DialogBoxParam, DialogBoxIndirect e DialogBoxIndirectParam devono essere eliminate usando la funzione EndDialog. Un'applicazione chiama EndDialog dalla procedura della finestra di dialogo; la funzione non deve essere usata per altri scopi.

Una procedura della finestra di dialogo può chiamare EndDialog in qualsiasi momento, anche durante l'elaborazione del messaggio di WM_INITDIALOG . Se l'applicazione chiama la funzione mentre viene elaborata WM_INITDIALOG , la finestra di dialogo viene eliminata prima che venga visualizzata e prima che venga impostata lo stato attivo di input.

EndDialog non elimina immediatamente la finestra di dialogo. Imposta invece un flag e consente alla procedura della finestra di dialogo di restituire il controllo al sistema. Il sistema controlla il flag prima di tentare di recuperare il messaggio successivo dalla coda dell'applicazione. Se il flag è impostato, il sistema termina il ciclo del messaggio, elimina la finestra di dialogo e usa il valore in nResult come valore restituito dalla funzione che ha creato la finestra di dialogo.

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
Set di API	ext-ms-win-ntuser-dialogbox-l1-1-0 (introdotto in Windows 8)