MFC-CWinApp

概览

CWinApp为应用程序类， CWinApp由 CWinThread 派生而来 ，后者表示可能具有一个或多个线程的应用程序的主执行线程，基于框架生成的应用程序必须有且仅有一个从 CWinApp 派生的类的对象并创建窗口之前先构造该对象 。

封装了Windows应用程序要做初始化、运行、终止3个主要任务，其对应的3个主要函数是InitInstance()、Run()、ExitInstance()，上述3函数与 OnIdle() 函数实际位于 CWinThread 类中。此处将这些函数作为 CWinApp 成员来探讨，因为探讨所关心的是对象作为应用程序对象而不是主线程的角色。

应用程序类构成应用程序的主线程，使用Win32 API也可以创建辅助线程，当然也可以使用MFC。

与其他类型Windows应用程序一样，MFC应用程序也有WinMain函数，此函数由类库提供，不必自己编写，并在应用程序启动时调用WinMain 执行注册窗口类等标准服务，后调用应用程序对象的成员函数初始化和运行应用程序，可通过重写由 WinMain 调用的 CWinApp 成员函数来自定义WinMain。

为初始化应用程序，WinMain 调用应用程序对象的 InitApplication 和 InitInstance 成员函数。为运行应用程序的消息循环，WinMain 调用 Run 成员函数。在终止时，WinMain 调用应用程序对象的 ExitInstance 成员函数。下图显示了框架应用程序中的执行顺序。

类成员

属性

m_pszAppName 指定了应用程序的名字
m_hInstance 标识了应用程序的当前实例
m_hPrevInstance 在32位应用程序中被设为NULL
m_lpCmdLine 指向一个以null结尾的字符串，指定了应用程序的命令行
m_nCmdShow 指定最初如何显示窗口
m_bHelpMode 指明用户是否处于Help上下文模式（通常用SHIFT+F1激活）
m_pActiveWnd 当一个OLE服务器是现场可激活时，它指向容器应用程序的主窗口
m_pszExeName 应用程序的模块名字
m_pszHelpFilePath 应用程序的帮助文件的路径
m_pszProfileName 应用程序的。INI文件名
m_pszRegistryKey 用于确定保存应用程序主要设置的完整的注册表键
m_pDocManager 用于保存文档模板管理类的指针(MSDN中没有这个数据成员)

方法

CWinApp 构造方法

LoadCursor 载入光标资源
LoadStandardCursor 载入WINDOWS.H中IDC_常量所指定的Windows预定义光标
LoadOEMCursor 载入WINDOWS.H中OCR_常量所指定的WindowsOEM预定义光标
LoadIcon 载入图标资源
LoadStandardIcon 载入WINDOWS.H中IDI_常量所指定的Windows预定义图标
LoadOEMIcon 载入WINDOWS.H中OIC_常量所指定的WindowsOEM预定义图标
RunAutomated 检查程序命令行是否指定/Automation选项。已不用。应当在调用ParseCommandLine之后使用CCommandLineInfo::m_bRunEmbedded中的值
RunEmbedded 检查程序命令行是否指定/Embedding选项。已不用。应当在调用ParseCommandLine之后使用CCommandLineInfo::m_bRunEmbedded中的值
ParseCommandLine 解析命令行中的每个参数和标志
ProcessShellCommand 处理命令行参数和标志
GetProfileInt 从应用程序的。INI文件的一个入口中获取一个整数
WriteProfileInt 将一个整数写到应用程序的。INI文件的入口
GetProfileString 从应用程序的。INI文件的一个入口中获取一个字符串
WriteProfileString 将一个字符串写到应用程序的。INI文件的入口
AddDocTemplate 将一个文档模板加到应用程序的可用文档模板列表中
GetFirstDocTemplatePosition 获取第一个文档模板的位置
GetNextDocTemplate 获得文档模板的位置。可以递归调用
OpenDocumentFile 由框架调用，用以从文件打开一个文档
AddToRecentFileList 将一个文件名加入最近使用（MRU）的文件列表
SelectPrinter 选择先前由用户在打印对话框中指定的打印机
CreatePrinterDC 创建一个打印机设备环境
GetPrinterDeviceDefaults 获得缺省的打印机设备

InitInstance 可被重载以执行Windows的实例初始化，比如创建窗口对象
InitApplication 初始化.
Run 运行缺省的消息循环。可被重载以定制消息循环
OnIdle 可被重载以执行应用程序指定的空闲时处理
ExitInstance 可被重载以在应用程序结束时执行清除操作
HideApplication 在关闭所有的文档之前隐藏应用程序
CloseAllDocuments 关闭所有打开的文档
PreTranslateMessage 在消息被分派到Windows函数::TranslateMessage和::DispatchMessage之前过滤消息
SaveAllModified 提示用户保存所有改变了的文档
DoMessageBox 为应用程序实现AfxMessageBox
ProcessMessageFilter 在消息到达应用程序之前截取特定的消息
ProcessWndProcException截取应用程序的消息和命令处理函数抛出的未被处理的异常
DoWaitCursor 打开或关闭等待光标
OnDDECommand 框架调用这个函数以响应动态数据交换（DDE）执行命令
WinHelp 调用Windows的WinHelp函数

LoadStdProfileSettings 载入标准的。INI文件设置并允许MRU文件列表特性
SetDialogBkColor 设置对话框和消息框的缺省背景颜色
SetRegistryKey 使应用程序的设置保存在注册表中，而不是INI文件中
EnableShellOpen 允许用户通过Windows的文件管理器打开数据文件
RegisterShellFileTypes 在Windows的文件管理器中注册所有的应用程序文档类型
Enable3dControls 使控件具有三维外观（动态库）
Enable3dControlsStatic 使控件具有三维外观（静态库）

OnFileNew 实现ID_FILE_NEW命令
OnFileOpen 实现ID_FILE_NEW命令
OnFilePrintSetup 实现ID_FILE_PRINT_SETUP命令
OnContextHelp 处理应用程序内的SHIFT+F1命令
OnHelp 处理应用程序内的F1帮助命令（使用当前的上下文）
OnHelpIndex 处理ID_HELP_INDEX命令，提供缺省的帮助主题
OnHelpFinder 处理ID_HELP_FINDER和ID_DEFAULT_HELP命令
OnHelpUsing 处理ID_HELP_USING命令