CDialog::OnInitDialog

Artikel
02/26/2013

Diese Methode wird in Reaktion auf die WM_INITDIALOG Meldung aufgerufen.

virtual BOOL OnInitDialog( );

Rückgabewert

Gibt an, dass die Anwendung den Eingabefokus auf eine der Steuerelemente im Dialogfeld festgelegt.Wenn OnInitDialog-Wert ungleich 0 zurückgibt, wird Windows den Eingabefokus am Standardspeicherort, das erste Steuerelement im Dialogfeld fest.Die Anwendung kann 0 zurückgeben, wenn sie explizit den Eingabefokus auf eine der Steuerelemente im Dialogfeld festgelegt.

Hinweise

Windows WM_INITDIALOG sendet die Nachricht in das Dialogfeld während der Erstellen Sie, CreateIndirect oder DoModal Aufrufe, die auftreten, unmittelbar bevor das Dialogfeld angezeigt wird.

Überschreiben Sie diese Methode, wenn Sie spezielles ausführen möchten, Verarbeitung, wenn das Dialogfeld initialisiert wird.In der überschriebenen Version ignorieren zunächst die Basisklasse OnInitDialog jedoch den Rückgabewert.Sie geben in der Regel TRUE von der überschriebenen Methode zurück.

Windows ruft die OnInitDialog-Funktion auf, indem sie das globale Dialogfeldprozedurstandardcommon auf alle Microsoft Foundation Class-Bibliothek-Dialogfeldern verwendet.Es ruft diese Funktion nicht von der Meldungszuordnung auf, daher benötigen Sie keinen Eintrag in der Meldungszuordnung für diese Methode.

Hinweis
Sie können diese Methode nicht überschreiben, wenn Sie ein CFileDialog-Objekt in einem Programm verwenden, das mit Windows Vista kompiliert wird.Weitere Informationen über Änderungen an CFileDialog unter Windows Vista finden Sie unter CFileDialog-Klasse.

Beispiel

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
}