CWinApp

基本信息

CWinApp为应用程序类

MFC 中的主应用程序类封装用于 Windows 操作系统的应用程序的初始化、运行和终止。基于框架生成的应用程序必须有且仅有一个从 CWinApp 派生的类的对象。在创建窗口之前先构造该对象。

CWinApp 是从 CWinThread 派生的,后者表示可能具有一个或多个线程的应用程序的主执行线程。在最新版本的 MFC 中,InitInstance、Run、ExitInstance 和 OnIdle 成员函数实际位于 CWinThread 类中。此处将这些函数作为 CWinApp 成员来探讨,因为探讨所关心的是对象作为应用程序对象而不是主线程的角色。

注意

应用程序类构成应用程序的主执行线程。使用 Win32 API 函数还可以创建辅助执行线程。这些线程可以使用 MFC 库。有关更多信息,请参见多线程编程。

与用于 Windows 操作系统的任何程序一样,框架应用程序也具有 WinMain 函数。但在框架应用程序中不必编写 WinMain。它由类库提供,并在应用程序启动时调用WinMain 执行注册窗口类等标准服务。然后它调用应用程序对象的成员函数来初始化和运行应用程序。(可通过重写由 WinMain 调用的 CWinApp 成员函数来自定义 WinMain。)

为初始化应用程序,WinMain 调用应用程序对象的 InitApplication 和 InitInstance 成员函数为运行应用程序的消息循环,WinMain 调用 Run 成员函数在终止时,WinMain 调用应用程序对象的 ExitInstance 成员函数。

执行顺序

注意 本文中以粗体显示的名称指示由 Microsoft 基础类库和 Visual C++ 提供的元素。以 monospaced 类型显示的名称指示您创建或重写的元素。

基于MFC的应用程序有一个应用对象,它是CWinApp派生类的对象,该对象代表了应用进程的主线程。当线程执行完并退出线程时,由于进程中没有其他线程存在,进程自动结束。类CWinApp从CWinThread派生出来,CWinThread是用户接口线程的基本类。我们在编写用户接口线程时,需要从CWinThread派生我们自己的线程类,ClassWizard可以帮助我们完成这个工作。

先用ClassWizard派生一个新的类,设置基类CWinThread。注意:类的DECLARE_DYNCREATE和IMPLEMENT_DYNCREATE宏是必需的,分别是声明动态创建和实现动态创建,因为创建线程时需要动态创建类的对象。根据需要可将初始化和结束代码分别放在类的InitInstanceExitInstance函数中。如果需要创建窗口,则可在InitInstance函数中完成。然后创建线程并启动线程。可以用两种方法来创建用户接口线程,MFC提供了两个版本的AfxBeginThread函数,其中一个用于创建用户接口线程。第二种方法分为两步进行:首先,调用线程类的构造函数创建一个线程对象;其次,调用CWinThread::CreateThread函数来创建该线程。线程建立并启动后,在线程函数执行过程中一直有效。如果是线程对象,则在对象删除之前,先结束线程。CWinThread已经为我们完成了线程结束的工作。

CWinApp类成员

数据成员

m_pszAppName

指定了应用程序的名字(p是pointer,因为名字是字符数组,p指向首地址)

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 构造一个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

载入标准的 xxx.INI 文件设置并允许MRU文件列表特性

SetDialogBkColor

设置对话框和消息框的缺省背景颜色

SetRegistryKey

使应用程序的设置保存在注册表中,而不是xxx.INI文件中

EnableShellOpen

允许用户通过Windows的文件管理器打开数据文件

RegisterShellFileTypes

在Windows的文件管理器中注册所有的应用程序文档类型

Enable3dControls

使控件具有三维外观(动态库)

Enable3dControlsStatic

使控件具有三维外观(静态库

命令操作

OnFileNew

实现ID_FILE_NEW命令

OnFileOpen

实现ID_FILE_OPEN命令

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命令

已标记关键词 清除标记
©️2020 CSDN 皮肤主题: 书香水墨 设计师:CSDN官方博客 返回首页