CDialog::OnInitDialog

Artykuł
06/10/2015

Ta metoda jest wywoływana w odpowiedzi na WM_INITDIALOG wiadomości.

virtual BOOL OnInitDialog( );

Wartość zwracana

Określa, czy aplikacja ma ustawiony fokus wprowadzania do jednego z formantów w oknie dialogowym.Jeśli OnInitDialog zwraca wartość niezerową, system Windows ustawia fokus wprowadzania domyślnej lokalizacji pierwszego formantu w oknie dialogowym.Aplikacja może zwracać 0 tylko wtedy, gdy wyraźnie ustawiono fokus wprowadzania jednego z formantów w oknie dialogowym.

Uwagi

System Windows wysyła WM_INITDIALOG komunikat do okna dialogowego podczas Tworzenie, CreateIndirect, lub DoModal wywołania, które natychmiast, zanim zostanie wyświetlone okno dialogowe.

Tej metody należy zastąpić, jeśli chcesz wykonać specjalnego przetwarzania, gdy okno dialogowe jest zainicjowany.W wersji przesłonięte pierwsze wywołanie klasy bazowej OnInitDialog , ale Ignoruj swojej zwracanej wartości.Zazwyczaj zwróci TRUE z metodę przesłonięte.

System Windows wywołuje OnInitDialog funkcji za pomocą wspólnej procedury standardowe globalnego okno dialogowe Microsoft Foundation klasy biblioteki wszystkie okna dialogowe.Nie wywołuje tę funkcję za pomocą mapy wiadomości i dlatego nie trzeba wpisie mapy wiadomości dla tej metody.

[!UWAGA]

Tej metody nie można zastąpić, korzystając z CFileDialog obiektu opracowane w ramach programu Windows Vista.Aby uzyskać więcej informacji o zmianach w CFileDialog pod Windows Vista zobacz Klasa CFileDialog.

Przykład

BOOL CSimpleDlg::OnInitDialog()
{
   CDialog::OnInitDialog();

   // TODO: Add extra initialization here
   m_cMyEdit.SetWindowText(_T("My Name")); // Initialize control values
   m_cMyList.ShowWindow(SW_HIDE);      // Show or hide a control, etc. 

   return TRUE;  // return TRUE unless you set the focus to a control 
   // EXCEPTION: OCX Property Pages should return FALSE
}