Partager via


CDialog::OnInitDialog

Cette méthode est appelée en réponse à le message d' WM_INITDIALOG .

virtual BOOL OnInitDialog( );

Valeur de retour

Spécifie si l'application a placé le focus d'entrée à l'un des contrôles dans la boîte de dialogue. Si OnInitDialog retourne une valeur différente de zéro, les fenêtres place le focus d'entrée à l'emplacement par défaut, le premier contrôle dans la boîte de dialogue. L'application peut retourner 0 uniquement si elle a explicitement le focus d'entrée à l'un des contrôles dans la boîte de dialogue.

Notes

Les fenêtres envoie le message d' WM_INITDIALOG à la boîte de dialogue lors de les appels de Create, de CreateIndirect, ou de DoModal , qui se produisent avant la boîte de dialogue s'affiche.

Substituez cette méthode si vous souhaitez effectuer le traitement spécial lorsque la boîte de dialogue est initialisée. Dans la version substituée, le premier appel la classe de base OnInitDialog mais ignorent sa valeur de retour. Vous renverrez en général TRUE de votre méthode substituée.

Les fenêtres appelle la fonction d' OnInitDialog à l'aide de la procédure de boîte de dialogue globale standard commune à toutes les boîtes de dialogue de la bibliothèque MFC. Il n'appelle pas la fonction dans votre table des messages par conséquent, vous n'avez pas besoin d'une entrée de la table des messages pour cette méthode.

Notes

Vous ne pouvez pas substituer cette méthode lorsque vous utilisez un objet d' CFileDialog dans un programme compilé sous Windows Vista.Pour plus d'informations sur les modifications apportées à CFileDialog sous Windows Vista consultez CFileDialog, classe.

Exemple

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
}

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CDialog, classe

Graphique de la hiérarchie

CDialog::Create

CDialog::CreateIndirect

WM_INITDIALOG