CWinApp::InitInstance

Les fenêtres permet à plusieurs copies du même programme pour s'exécuter simultanément.

virtual BOOL InitInstance( );

Valeur de retour

Une valeur différente de zéro si l'initialisation est réussie ; sinon 0.

Notes

L'initialisation d'application est conceptuellement divisée en deux sections : l'initialisation une fois d'application qui est faite pour la première fois le programme s'exécute, et l'initialisation d'instance qui s'exécute chaque fois qu'une copie des séries de programme, notamment la première fois.L'implémentation de l'infrastructure d' WinMain appelle cette fonction.

Substituez InitInstance pour initialiser chaque nouvelle instance de votre application sous windows.En général, vous substituez InitInstance pour construire votre objet window principal et pour définir le membre d' CWinThread::m_pMainWnd pour indiquer cette fenêtre.Pour plus d'informations sur la substitution cette fonction membre, consultez CWinApp : La classe d'application.

[!REMARQUE]

Les applications MFC doivent être initialisées en tant que thread apartment (STA) unique.Si vous appelez CoInitializeEx dans la substitution d' InitInstance , spécifiez COINIT_APARTMENTTHREADED (plutôt qu' COINIT_MULTITHREADED).Pour plus d'informations, consultez PRB : L'application MFC cesse de répondre lorsque vous initialisez l'application comme apartment) (828643) dans https://support.microsoft.com/default.aspx?scid=kb;en-us;828643.

Exemple

// AppWizard implements the InitInstance overridable function 
// according to options you select.  For example, the multiple document
// interface (MDI) option was chosen for the AppWizard code created
// below. You can add other per-instance initializations to the code
// created by AppWizard.

BOOL CMFCListViewApp::InitInstance()
{
   AfxSetAmbientActCtx(FALSE);
   // Remainder of function definition omitted.

   CWinApp::InitInstance();

   // Initialize OLE libraries
   if (!AfxOleInit())
   {
      AfxMessageBox(_T("OleInit failed."));
      return FALSE;
   }

   // Standard initialization
   // If you are not using these features and wish to reduce the size
   // of your final executable, you should remove from the following
   // the specific initialization routines you do not need
   // Change the registry key under which our settings are stored
   // TODO: You should modify this string to be something appropriate
   // such as the name of your company or organization
   SetRegistryKey(_T("Local AppWizard-Generated Applications"));
   LoadStdProfileSettings(4);  // Load standard INI file options (including MRU)
   // Register the application's document templates.  Document templates
   //  serve as the connection between documents, frame windows and views
   CMultiDocTemplate* pDocTemplate;
   pDocTemplate = new CMultiDocTemplate(IDR_MFCListViewTYPE,
      RUNTIME_CLASS(CMFCListViewDoc),
      RUNTIME_CLASS(CChildFrame), // custom MDI child frame
      RUNTIME_CLASS(CMyListView));
   if (!pDocTemplate)
      return FALSE;
   AddDocTemplate(pDocTemplate);

   // create main MDI Frame window
   CMainFrame* pMainFrame = new CMainFrame;
   if (!pMainFrame || !pMainFrame->LoadFrame(IDR_MAINFRAME))
   {
      delete pMainFrame;
      return FALSE;
   }
   m_pMainWnd = pMainFrame;
   // call DragAcceptFiles only if there's a suffix
   //  In an MDI app, this should occur immediately after setting m_pMainWnd


   // Parse command line for standard shell commands, DDE, file open
   CCommandLineInfo cmdInfo;
   ParseCommandLine(cmdInfo);


   // Dispatch commands specified on the command line.  Will return FALSE if
   // app was launched with /RegServer, /Register, /Unregserver or /Unregister.
   if (!ProcessShellCommand(cmdInfo))
      return FALSE;
   // The main window has been initialized, so show and update it
   pMainFrame->ShowWindow(m_nCmdShow);
   pMainFrame->UpdateWindow();

   return TRUE;
}

Configuration requise

Header: afxwin.h

Voir aussi

Référence

Classe de CWinApp

Graphique de la hiérarchie