共用方式為


CWinApp 類別

您會取得一個 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 函式 TranslateMessageDispatchMessage之前。

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_FINDERID_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

繼承階層架構

CObject

CCmdTarget

CWinThread

CWinApp

需求

**標頭檔:**afxwin.h

請參閱

工作

如何:加入重新啟動管理員支援

參考

CWinThread 類別

階層架構圖表