Klasa CSimpleDialog
Ta klasa implementuje podstawowe modalne okno dialogowe.
Składnia
template <WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE>
class CSimpleDialog : public CDialogImplBase
Parametry
t_wDlgTemplateID
Identyfikator zasobu szablonu okna dialogowego.
t_bCenter
WARTOŚĆ TRUE, jeśli obiekt okna dialogowego ma być wyśrodkowany w oknie właściciela; w przeciwnym razie FAŁSZ.
Elementy członkowskie
Metody publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CSimpleDialog::D oModal | Tworzy modalne okno dialogowe. |
Uwagi
Implementuje modalne okno dialogowe z podstawową funkcjonalnością. CSimpleDialog Zapewnia obsługę tylko typowych kontrolek systemu Windows. Aby utworzyć i wyświetlić modalne okno dialogowe, utwórz wystąpienie tej klasy, podając nazwę istniejącego szablonu zasobu dla okna dialogowego. Obiekt okna dialogowego zamyka się, gdy użytkownik kliknie dowolną kontrolkę ze wstępnie zdefiniowaną wartością (taką jak IDOK lub IDCANCEL).
CSimpleDialog umożliwia tworzenie tylko modalnych okien dialogowych. CSimpleDialog Zawiera procedurę okna dialogowego, która używa domyślnej mapy komunikatów do kierowania komunikatów do odpowiednich procedur obsługi.
Aby uzyskać więcej informacji, zobacz Implementowanie okna dialogowego .
Hierarchia dziedziczenia
CDialogImplBase
CSimpleDialog
Wymagania
Nagłówek: atlwin.h
CSimpleDialog::D oModal
Wywołuje modalne okno dialogowe i zwraca wynik okna dialogowego po zakończeniu.
INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());
Parametry
hWndParent
Uchwyt do elementu nadrzędnego okna dialogowego. Jeśli nie podano żadnej wartości, element nadrzędny jest ustawiony na bieżące aktywne okno.
Wartość zwracana
Jeśli operacja powiedzie się, zwracana wartość to identyfikator zasobu kontrolki, która odrzuciła okno dialogowe.
Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość to -1. Aby uzyskać rozszerzone informacje o błędzie, wywołaj metodę GetLastError.
Uwagi
Ta metoda obsługuje całą interakcję z użytkownikiem, gdy okno dialogowe jest aktywne. To właśnie sprawia, że okno dialogowe jest modalne; oznacza to, że użytkownik nie może wchodzić w interakcje z innymi oknami, dopóki okno dialogowe nie zostanie zamknięte.