Udostępnij za pośrednictwem

Klasa CSimpleDialog

  • Artykuł

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.

Członkowie

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.

Zobacz też

Omówienie klasy