CWinApp::InitInstance
As janelas permitem que várias cópias do mesmo programa para executar ao mesmo tempo.
virtual BOOL InitInstance( );
Valor de retorno
Diferente de zero se a inicialização for bem-sucedida; se não 0.
Comentários
A inicialização do aplicativo é dividida em duas seções: conceitual a única inicialização do aplicativo que é feita a primeira vez o programa é executado, e a instância que a inicialização que executa sempre que uma cópia do programa é executado, incluindo a primeira vez.A implementação de layout de WinMain chama essa função.
Substitua InitInstance para inicializar cada nova instância da sua execução do aplicativo do windows.Normalmente, você substitui InitInstance para construir o objeto da janela principal e definir o membro de dados de CWinThread::m_pMainWnd para apontar para a janela.Para obter mais informações sobre como substituir essa função de membro, consulte CWinApp: A classe do aplicativo.
.gif "Observação") Observação |
|---|
Os aplicativos MFC deve ser inicializada como o threaded apartment (STA).Se você chamar CoInitializeEx em sua sobrescrita de InitInstance , especifique COINIT_APARTMENTTHREADED (em vez de COINIT_MULTITHREADED).Para obter mais informações, consulte PRB: O aplicativo MFC de para responder quando você inicializa o aplicativo como um apartamento Multithreaded (828643) em https://support.microsoft.com/default.aspx?scid=kb;en-us;828643. |
Exemplo
// 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;
}
Requisitos
Cabeçalho: afxwin.h