Klasa CDialog

Artykuł
06/10/2015

Klasa podstawowa dla wyświetlania okien dialogowych, na ekranie.

class CDialog : public CWnd

Członkowie

Publiczne konstruktory

Nazwa	Opis
CDialog::CDialog	Konstrukcje CDialog obiektu.

Metody publiczne

Nazwa	Opis
CDialog::Create	Inicjuje CDialog obiektu.Tworzy niemodalne okno dialogowe i dołącza go do CDialog obiektu.
CDialog::CreateIndirect	Tworzy niemodalne okno dialogowe z szablonu okno dialogowe w pamięci (nie opartych na zasobach).
CDialog::DoModal	Wywołuje modalnego okna dialogowego i zwraca po zakończeniu.
CDialog::EndDialog	Zamyka okno dialogowe.
CDialog::GetDefID	Pobiera identyfikator formantu pushbutton domyślne okna dialogowego.
CDialog::GotoDlgCtrl	Przenosi fokus do formantu okno dialogowe określony w oknie dialogowym.
CDialog::InitModalIndirect	Tworzy modalnego okna dialogowego z szablonu okno dialogowe w pamięci (nie opartych na zasobach).Parametry są przechowywane aż do funkcji DoModal jest wywoływana.
CDialog::MapDialogRect	Konwertuje jednostek okno dialogowe prostokąt jednostek ekranu.
CDialog::NextDlgCtrl	Przenosi fokus do następnego formantu okno dialogowe, w oknie dialogowym.
CDialog::OnInitDialog	Zastąpić uzupełniającej okno dialogowe Inicjowanie.
CDialog::OnSetFont	Zastąpić, aby określić czcionkę, która jest sterowania okno dialogowe podczas zwraca tekst.
CDialog::PrevDlgCtrl	Przenosi fokus do poprzedniego formantu okno dialogowe, w oknie dialogowym.
CDialog::SetDefID	Zmienia domyślny formant pushbutton okna dialogowego określony z przyciskiem.
CDialog::SetHelpID	Ustawia identyfikator pomocy kontekstowej w oknie dialogowym.

Metody chronione

Nazwa	Opis
CDialog::OnCancel	Zastąpić do wykonywania akcji klawiszy ESC lub przycisk Anuluj.Domyślnie zamyka okno dialogowe i DoModal zwraca IDCANCEL.
CDialog::OnOK	Zastąpić do wykonania akcji przycisk OK w oknie dialogowym modalne.Domyślnie zamyka okno dialogowe i DoModal zwraca IDOK.

Uwagi

Okna dialogowe są dwa typy: modalny i niemodalny.Modalne okno dialogowe muszą być zamknięte przez użytkownika, aby aplikacja kontynuuje.Niemodalne okno dialogowe pozwala wyświetlić okno dialogowe i powrót do innego zadania bez anulowanie lub usuwanie okno dialogowe.

A CDialog obiektu jest kombinacją szablonu okno dialogowe i CDialog-klasy.Użyj edytora okno dialogowe, aby utworzyć szablon okno dialogowe i zapisać go w zasobu, a następnie użyj Kreatora dodawania klasy do tworzenia klasy pochodzącej od CDialog.

Okno dialogowe, podobnie jak inne okna odbiera wiadomości z systemu Windows.W oknie dialogowym są szczególnie zainteresowani obsługi wiadomości powiadomień z formantów w oknie dialogowym, ponieważ użytkownik współdziałania z Twoje okno dialogowe.Okno Właściwości zaznacz wiadomości, które chcesz do uchwytu i doda wpisy odpowiednią mapę wiadomości i funkcje składowe obsługi wiadomości do klasy dla Ciebie.Wystarczy napisać kod specyficzny dla aplikacji w funkcje obsługi Członkowskich.

Jeśli wolisz, możesz zawsze napisać wpisy mapy wiadomości i funkcje składowe ręcznie.

We wszystkich, ale okno dialogowe najbardziej trivial dodanie zmienne składowe klasy pochodnej okno dialogowe do przechowywania danych wprowadzonych w oknie dialogowym formantów przez użytkownika lub do wyświetlania danych użytkownika.Dodawanie zmiennej Kreator umożliwia tworzenie Członkowskie zmiennych i skojarzyć je z kontroli.Jednocześnie wybierz typ zmiennej i dopuszczalny zakres wartości dla każdej zmiennej.Kreator kod dodaje zmienne składowe do klasy pochodnej okno dialogowe.

Mapa danych jest generowany automatycznie obsługiwać wymianę danych między zmienne składowe i formanty okna dialogowego.Mapa danych zawiera funkcje, które zainicjować formantów w oknie dialogowym prawidłowe wartości pobierania danych i sprawdzania poprawności danych.

Aby utworzyć modalnego okna dialogowego, utworzenia obiektu na stos za pomocą konstruktora klasy pochodnej okno dialogowe, a następnie wywołać DoModal Tworzenie okna dialogowego i jego formantów.Jeśli chcesz utworzyć niemodalne okno dialogowe wywołanie Tworzenie w konstruktorze klasy okno dialogowe.

Można także utworzyć szablon w pamięci, za pomocą DLGTEMPLATE struktury danych opisane w Windows SDK.Po konstrukcji CDialog obiektów, call CreateIndirect niemodalny utworzyć okno dialogowe lub wywołanie InitModalIndirect i DoModal utworzyć modalnego okna dialogowego.

Mapy wymiany i sprawdzania poprawności danych jest pisany przesłonięcie CWnd::DoDataExchange dodaje się do nowej klasy okno dialogowe.Zobacz DoDataExchange Członkowskich funkcji w CWnd więcej informacji na temat funkcji programu exchange i sprawdzania poprawności.

Programista i wywołanie RAM DoDataExchange pośrednio poprzez wywołanie CWnd::UpdateData.

Wywołania RAM UpdateData , kiedy użytkownik kliknie przycisk OK, aby zamknąć okno dialogowe modalne.(Nie pobierania danych po kliknięciu przycisku Anuluj.) Domyślne wykonania OnInitDialog wymaga również UpdateData do ustawiania wartości początkowej formantów.Zwykle zastępują OnInitDialog zainicjować dalszych kontroli.OnInitDialognazywa się po wszystkich formantów okno dialogowe są tworzone i tuż przed okno dialogowe jest wyświetlane okno.

Można wywołać CWnd::UpdateData w czasie realizacji okno dialogowe modalny lub niemodalny.

Jeśli okno dialogowe jest opracowanie ręcznie, możesz dodać zmienne składowe niezbędne do klasy pochodnej okno dialogowe samodzielnie i dodawanie funkcji elementów członkowskich, aby ustawić lub pobrać te wartości.

Modalne okno dialogowe zostanie zamknięte automatycznie po naciśnięciu przycisku OK lub Anuluj lub gdy kod wywołuje EndDialog funkcji składowej.

Podczas implementowania niemodalne okno dialogowe zawsze zastępują OnCancel Członkowskich funkcji i wywołania DestroyWindow od wewnątrz.Nie wywołuj klasy bazowej CDialog::OnCancel, ponieważ wymaga on EndDialog, który będzie niewidoczna okno dialogowe, ale nie spowoduje zniszczenia.Należy również zastąpić PostNcDestroy niemodalny okien dialogowych, aby usunąć to, ponieważ okna dialogowe niemodalny są zazwyczaj przydzielane z Nowy.Zazwyczaj są zbudowane na ramce modalnych okien dialogowych i nie ma potrzeby PostNcDestroy oczyszczania.

Aby uzyskać więcej informacji na CDialog, zobacz: