Funzione EndDialog (winuser.h)
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) |
Vedi anche
Informazioni concettuali
Riferimento