Classe CSimpleDialog
Questa classe implementa una finestra di dialogo modale di base.
Sintassi
template <WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE>
class CSimpleDialog : public CDialogImplBase
Parametri
t_wDlgTemplateID
ID risorsa della risorsa modello di finestra di dialogo.
t_bCenter
TRUE se l'oggetto dialogo deve essere centrato sulla finestra di proprietario; in caso contrario FALSE.
Membri
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CSimpleDialog::D oModal | Crea una finestra di dialogo modale. |
Osservazioni:
Implementa una finestra di dialogo modale con funzionalità di base. CSimpleDialog fornisce supporto solo per i controlli comuni di Windows. Per creare e visualizzare una finestra di dialogo modale, creare un'istanza di questa classe, specificando il nome di un modello di risorsa esistente per la finestra di dialogo. L'oggetto finestra di dialogo si chiude quando l'utente fa clic su qualsiasi controllo con un valore predefinito, ad esempio IDOK o IDCANCEL.
CSimpleDialog consente di creare solo finestre di dialogo modali. CSimpleDialog fornisce la procedura della finestra di dialogo, che usa il mapping dei messaggi predefinito per indirizzare i messaggi ai gestori appropriati.
Per altre informazioni, vedere Implementazione di una finestra di dialogo .
Gerarchia di ereditarietà
CDialogImplBase
CSimpleDialog
Requisiti
Intestazione: atlwin.h
CSimpleDialog::D oModal
Richiama una finestra di dialogo modale e restituisce il risultato della finestra di dialogo al termine.
INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());
Parametri
hWndParent
Handle per l'elemento padre della finestra di dialogo. Se non viene specificato alcun valore, l'elemento padre viene impostato sulla finestra attiva corrente.
Valore restituito
In caso di esito positivo, il valore restituito è l'ID risorsa del controllo che ha ignorato la finestra di dialogo.
Se la funzione ha esito negativo, il valore restituito è -1. Per ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni:
Questo metodo gestisce tutte le interazioni con l'utente mentre la finestra di dialogo è attiva. Questo è ciò che rende modale la finestra di dialogo; ovvero, l'utente non può interagire con altre finestre finché la finestra di dialogo non viene chiusa.