CWinApp 類別

發行項
03/15/2013

您會取得一個 Windows 應用程式物件的基底類別。

class CWinApp : public CWinThread

成員

公用建構函式

名稱	描述
CWinApp::CWinApp	建構 CWinApp 物件。

公用方法

名稱	描述
CWinApp::AddDocTemplate	將文件範本加入至可用的資料範本應用程式清單。
CWinApp::AddToRecentFileList	將檔案名稱加入至最近使用 (MRU) 的檔案清單。
CWinApp::ApplicationRecoveryCallback	呼叫由架構，在應用程式意外關閉。
CWinApp::CloseAllDocuments	關閉所有開啟的文件。
CWinApp::CreatePrinterDC	建立印表機內容。
CWinApp::DelRegTree	刪除指定的機碼及其一切子機碼。
CWinApp::DoMessageBox	應用程式的實作 AfxMessageBox 。
CWinApp::DoWaitCursor	開啟和關閉等待游標。
CWinApp::EnableD2DSupport	啟用應用程式 D2D 支援。初始化主視窗之前，呼叫這個方法。
CWinApp::EnableHtmlHelp	應用程式的實作，而不是 HTMLHelp WinHelp。
CWinApp::EnableTaskbarInteraction	啟用工作列互動。
CWinApp::ExitInstance	清除的覆寫，以便在應用程式結束。
CWinApp::GetApplicationRecoveryParameter	擷取應用程式復原方法的輸入參數。
CWinApp::GetApplicationRecoveryPingInterval	傳回重新啟動管理員等候復原回呼函式傳回的時間。
CWinApp::GetApplicationRestartFlags	傳回重新啟動管理員的旗標。
CWinApp::GetAppRegistryKey	以下的\"Software"\RegistryKey\ProfileName RETURN 鍵。
CWinApp::GetDataRecoveryHandler	取得應用程式的這個執行個體的資料復原管理員。
CWinApp::GetFirstDocTemplatePosition	擷取第一個文件範本的位置。
CWinApp::GetHelpMode	擷取應用程式使用之說明的型別。
CWinApp::GetNextDocTemplate	擷取文件範本的位置。可以遞迴地使用。
CWinApp::GetPrinterDeviceDefaults	擷取預設印表機。
CWinApp::GetProfileBinary	從應用程式的 .INI 檔中的項目擷取二進位資料。
CWinApp::GetProfileInt	從應用程式的 .INI 檔中的項目擷取整數。
CWinApp::GetProfileString	從應用程式的 .INI 檔中的項目擷取字串。
CWinApp::GetSectionKey	以下的\"Software"\RegistryKey\AppName\lpszSection RETURN 鍵。
CWinApp::HideApplication	在關閉文件之前隱藏應用程式。
CWinApp::HtmlHelp	HTMLHelp 呼叫 Windows 函式。
CWinApp::InitInstance	執行 Windows 的覆寫執行個體初始化，例如建立自己的視窗物件。
CWinApp::IsTaskbarInteractionEnabled	告知 Windows 7 工作列互動是否啟用。
CWinApp::LoadCursor	載入游標資源。
CWinApp::LoadIcon	載入一個圖示資源。
CWinApp::LoadOEMCursor	載入 OCR_ 常數在 WINDOWS.H. 指定的視窗 OEM 預先定義的游標。
CWinApp::LoadOEMIcon	載入 OIC_ 常數在 WINDOWS.H. 指定的視窗 OEM 預先定義的圖示。
CWinApp::LoadStandardCursor	載入 IDC_ 常數在 WINDOWS.H. 指定的視窗預先定義的游標。
CWinApp::LoadStandardIcon	載入 IDI_ 常數在 WINDOWS.H. 指定的視窗預先定義的圖示。
CWinApp::OnDDECommand	呼叫框架以回應動態資料交換 (DDE) (DDE) 執行命令。
CWinApp::OnIdle	執行應用程式特有閒置時間處理的覆寫。
CWinApp::OpenDocumentFile	呼叫框架開啟檔案從檔案。
CWinApp::ParseCommandLine	在命令列剖析個別參數和旗標。
CWinApp::PreTranslateMessage	篩選訊息，然後才會分派給 Windows 函式 TranslateMessage 和 DispatchMessage之前。
CWinApp::ProcessMessageFilter	攔截特定訊息，並在到達應用程式。
CWinApp::ProcessShellCommand	處理命令列引數和旗標。
CWinApp::ProcessWndProcException	攔截應用程式的訊息和命令處理常式所擲回的所有未處理的例外狀況。
CWinApp::Register	執行自訂記錄檔。
CWinApp::RegisterWithRestartManager	登錄使用重新啟動管理員的應用程式。
CWinApp::ReopenPreviousFilesAtRestart	判斷重新啟動管理員是否重新開啟的檔案，在應用程式意外關閉。
CWinApp::RestartInstance	處理序重新啟動管理員所啟始的重新啟動應用程式。
CWinApp::RestoreAutosavedFilesAtRestart	判斷重新啟動管理員是否要還原自動儲存的檔案，並重新啟動應用程式。
CWinApp::Run	執行預設的訊息迴圈。自訂訊息迴圈的覆寫。
CWinApp::RunAutomated	提供 /Automation 選取測試應用程式的命令列。已過時。相反地，請使用值。 CCommandLineInfo::m_bRunAutomated 在呼叫 ParseCommandLine之後。
CWinApp::RunEmbedded	提供 /Embedding 選取測試應用程式的命令列。已過時。相反地，請使用值。 CCommandLineInfo::m_bRunEmbedded 在呼叫 ParseCommandLine之後。
CWinApp::SaveAllModified	提示使用者儲存修改過的資料。
CWinApp::SelectPrinter	選取使用者先前運算式中的印表機可以列印對話方塊。
CWinApp::SetHelpMode	集合並初始化應用程式使用之說明的型別。
CWinApp::SupportsApplicationRecovery	判斷重新啟動管理員是否復原非預期地結束應用程式。
CWinApp::SupportsAutosaveAtInterval	判斷重新啟動管理員是否自動儲存開啟的文件在將組建排入佇列。
CWinApp::SupportsAutosaveAtRestart	判斷重新啟動管理員是否自動儲存所有開啟的文件，在應用程式重新啟動。
CWinApp::SupportsRestartManager	判斷應用程式是否支援重新啟動管理員。
CWinApp::Unregister	移除註冊所有已知由 CWinApp 物件註冊。
CWinApp::WinHelp	WinHelp 呼叫 Windows 函式。
CWinApp::WriteProfileBinary	將項目寫入二進位資料在應用程式中 .INI 檔。
CWinApp::WriteProfileInt	將項目寫入整數在應用程式的 .INI 檔。
CWinApp::WriteProfileString	將輸入字串寫入應用程式的 .INI 檔。

受保護的方法

名稱	描述
CWinApp::EnableShellOpen	允許使用者從開啟視窗檔案管理員的資料檔案。
CWinApp::LoadStdProfileSettings	載入標準 .INI 檔設定和啟用 MRU 檔案清單功能。
CWinApp::OnContextHelp	在應用程式中的控制代碼 SHIFT+F1 說明。
CWinApp::OnFileNew	實作 ID_FILE_NEW 命令。
CWinApp::OnFileOpen	實作 ID_FILE_OPEN 命令。
CWinApp::OnFilePrintSetup	實作 ID_FILE_PRINT_SETUP 命令。
CWinApp::OnHelp	在應用程式中的控制代碼 F1 說明 (使用目前的內容)。
CWinApp::OnHelpFinder	處理 ID_HELP_FINDER 和 ID_DEFAULT_HELP 命令。
CWinApp::OnHelpIndex	處理 ID_HELP_INDEX 命令並提供預設的說明主題。
CWinApp::OnHelpUsing	處理 ID_HELP_USING 命令。
CWinApp::RegisterShellFileTypes	註冊所有與 Windows 檔案管理員之應用程式的文件類型。
CWinApp::SetAppID	明確設定應用程式使用者應用程式模型的 ID。應該呼叫這個方法，在所有使用者介面呈現給使用者之前 (最佳位置是應用程式的建構函式)。
CWinApp::SetRegistryKey	在登錄中建立應用程式設定儲存而非 .INI 檔。
CWinApp::UnregisterShellFileTypes	移除註冊所有與 Windows 檔案管理員之應用程式的文件類型。

公用資料成員

名稱	描述
CWinApp::m_bHelpMode	表示使用者是否在說明內容模式 (通常會叫用 (Invoke) SHIFT+F1)。
CWinApp::m_eHelpType	指定應用程式使用之說明的型別。
CWinApp::m_hInstance	識別應用程式的目前執行個體。
CWinApp::m_lpCmdLine	為應用程式指定命令列的 NULL 結尾字串的點。
CWinApp::m_nCmdShow	指定視窗如何一開始會顯示。
CWinApp::m_pActiveWnd	指標容器應用程式的主視窗，當一個 OLE 伺服器是就地啟動。
CWinApp::m_pszAppID	應用程式模型使用者 ID.
CWinApp::m_pszAppName	指定應用程式的名稱。
CWinApp::m_pszExeName	應用程式的模組名稱。
CWinApp::m_pszHelpFilePath	應用程式的說明檔的路徑。
CWinApp::m_pszProfileName	應用程式的 .INI 檔名。
CWinApp::m_pszRegistryKey	用來判斷儲存應用程式設定檔設定完整登錄機碼。

受保護的資料成員

名稱	描述
CWinApp::m_dwRestartManagerSupportFlags	旗標判斷重新啟動管理員的行為方式。
CWinApp::m_nAutosaveInterval	時間之間的毫秒自動儲存。
CWinApp::m_pDataRecoveryHandler	對資料復原管理員的指標應用程式的。

備註

應用程式物件的成員函式以初始化應用程式 (和每個執行個體) 以及執行應用程式。

使用 Microsoft Foundation Class 的每個應用程式只能包含 CWinApp從衍生的物件。這會建構物件，而其他 C++ 全域建構物件時已經存在，便可以使用視窗 WinMain 呼叫函式時， MFC 程式庫提供。宣告您的衍生 CWinApp 物件在全域層級。

當您從 CWinApp衍生時應用程式類別，請覆寫 InitInstance 成員函式來建置應用程式的主視窗物件。

除了 CWinApp 成員函式之外， MFC 程式庫提供下列全域函式存取您的 CWinApp 物件和其他全域資訊:

AfxGetApp 取得指標 CWinApp 物件。
AfxGetInstanceHandle 取得的控制代碼目前應用程式執行個體。
AfxGetResourceHandle 取得的控制代碼傳遞給應用程式的資源。
AfxGetAppName 衍生的指標會包含應用程式名稱的字串。此外，因此，如果您有一個指標 CWinApp 物件，請使用 m_pszExeName 取得應用程式名稱。

如需更多參閱 CWinApp:應用程式類別在 CWinApp 類別的概觀，包括下列:

CWinApp-應用程式精靈所撰寫的衍生的程式碼。
在應用程式執行順序的 CWinApp 的效果。
CWinApp 的預設成員函式的實作。
CWinApp 的金鑰 overridables。

m_hPrevInstance 資料成員不存在。如需偵測 CWinApp前一個執行個體的詳細資訊，請參閱知識庫文件<如何識別應用程式的前一個執行個體」(KB106385) 中 https://support.microsoft.com/default.aspx?scid=kb;en-us;106385。