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; altrimenti FAL edizione Standard.

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.

Vedi anche

Cenni preliminari sulla classe