CWinApp选件类

项目
03/01/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	HKEY_CURRENT_USER \ 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	HKEY_CURRENT_USER \ software \ “”的RegistryKey \ AppName \ lpszSection return键。
CWinApp::HideApplication	在结束所有文档之前，隐藏应用程序。
CWinApp::HtmlHelp	调用 HTMLHelp Windows功能。
CWinApp::InitInstance	执行Windows实例初始化的重写，例如创建windows对象。
CWinApp::IsTaskbarInteractionEnabled	指示Windows 7任务栏交互是否启用。
CWinApp::LoadCursor	加载一种光标资源。
CWinApp::LoadIcon	加载一个图标资源。
CWinApp::LoadOEMCursor	加载 OCR_ 常数。WINDOWS.H.指定了Windows OEM预定义的光标。
CWinApp::LoadOEMIcon	加载 OIC_ 常数。WINDOWS.H.中指定了Windows OEM预定义的图标。
CWinApp::LoadStandardCursor	加载 IDC_ 常数。WINDOWS.H.指定了Windows预定义的光标。
CWinApp::LoadStandardIcon	加载 IDI_ 常数。WINDOWS.H.中指定了Windows预定义的图标。
CWinApp::OnDDECommand	调用由框架以响应动态数据交换(dde) (DDE)执行命令。
CWinApp::OnIdle	执行特定于应用程序空闲时间处理的重写。
CWinApp::OpenDocumentFile	调用由框架打开文档从文件。
CWinApp::ParseCommandLine	分析各个参数和标志。命令行。
CWinApp::PreTranslateMessage	筛选器消息，并在调度到Windows之前函数 TranslateMessage 和 DispatchMessage。
CWinApp::ProcessMessageFilter	截获某些消息，然后在到达应用程序。
CWinApp::ProcessShellCommand	处理命令行参数和标志。
CWinApp::ProcessWndProcException	截获应用程序的消息和命令处理程序引发的异常。
CWinApp::Register	performs自定义注册。
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	允许用户从打开Windows文件管理器的数据文件。
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	指示用户是否在帮助上下文模式下(通常为调用具有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基础选件类的每个应用程序只能包含从 CWinApp派生的对象。此对象构造，当其他C++全局对象构造时且已可用，当Windows调用 WinMain 函数时，Microsoft基础选件类库提供。声明您的派生 CWinApp 对象在全局级。

当从 CWinApp派生时应用程序选件类，请重写 InitInstance 成员函数创建应用程序的主窗口对象。

除了 CWinApp 成员函数外，Microsoft基础选件类库提供以下全局函数访问您的 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。