CWinApp

 描述  
      CWinApp类是所在Windows应用 程序 的基类.CWinApp为初始化每个应用程序的实例   提供成员函数.每个使用MFC的 应用 程序中只能含有一个CWinApp的派生对象.当其   他C++全局对象被构造,这个CWinApp对象也被构造;并且在Windows调用WinMain()   函数时可用.WinMain()函数已经包括在MFC基础类中了.  
   
   
  数据成员    
   
  m_bHelpMode  
  如果应用程序在上下文帮助的方式下,该成员为TRUE.在上下文帮助的方式下,   光标为一个浮动的问号.当程序想在帮助方式下实现一个特定的功能时,使用   这个标志很有用.  
   
  m_hInstance  
  标识应用程序当前实例的句柄.  
   
  m_hPrevInstance  
  标识应用程序前一个实例的句柄.(如果当前实例为第一个,由该参数为Null).  
   
  m_lpCmdLine  
  指向以Null结束的字符串,该字符串标识应用程序的命令行  
   
  m_nCmdShow  
  一个ShowWindow枚举类型的成员.它指明当前实例下窗口的显示方式  
   
  m_pAcitveWnd  
  指向应用程序的主窗口.对于OLE服务器,该成员指向当前活跃的窗口.  
   
  m_pszAppName  
  应用程序名  
   
  m_pszExeName  
  应用程序的模块名.  
   
  m_pszHelpFile  
  应用程序的帮助文件的路径  
   
  m_pszProFileName  
  应用程序配置文件名(.ini)  
   
  m_pszRegistryKey  
  用于确定存储在应用程序剖面设置中的完整的注册关键字.(在Windows   NT下使用)  
   
  　  
   
  成员函数    
   
  AddDocTemplate    
  将一个文档模板加入到应用程序可用文档模板的列表中.建议在调用   RegisterShellFileTypes函数前调用该函数.    
  AddToRecentFileList    
  在MRU(Most   Recently   Used)文件列表中加入lpszPathName.在调用该函数   前,可调用LoadStdProfileSettings成员函数来装载当前MRU文件列表.当应用   程序打开一个文档或"另存为"一个文档时,框架就调用该函数    
  CloseAllDocuments    
  在退出之前将所有打开的文档都关闭.建议在调用CloseAllDocuments之前先   调用HideApplication函数    
  CreatePrinterDC    
  在选定的打印机中创建一个打印设备环境    
  DoMessageBox    
  框架调用该成员函数来为AfxMessageBox实用函数实现一个消息框.重载该成   员函数可以定制应用程序级的AfxMessageBox函数调用的处理过程.最好不要使用   该函数来打开消息框(应该使用AfxMessageBox函数)    
  DoWaitCursor    
  显示一个等待光标或恢复调用DoWaitCursor前的光标.框架调用该函数来实现   CWaitCursor,CCmdTarget::BeginWaitCursor,CCmdTarget::EndWaitCursor和   CCmdTarget::RestoreWaitCursor.其缺省实现是显示一个时间沙漏光标.DoWaitCursor   维护一个引用计数.当引用计数减到0时,恢复以前的光标.    
  Enable3dControls    
  使3D控件能在Ctl3D静态库中实现.该函数在95下不起任何作用.它允许三维外   观的对话框或窗口.当链接到MFC框架的DLL库时,应该调用Enable3dControls并装载   CTL3D32.DLL库    
  Enable3dControlsStatic    
  使3D控件在Ctl3D静态库中实现.该函数在95下不起任何作用.它允许三维外   观的对话框或窗口.当静态接到MFC框架的DLL库时,应该调用Enable3dControls并   装载CTL3D32.DLL库    
  EnableShellOpen    
  在Windows文件管理器中双击文件时能自动打开该文件.调用RegisterShell-   FileTypes成员函数可以在Windows95和NT下提供更多的界面支持.或者可以给应   用程序提供一个注册数据库文件(.reg),以便人工注册文档类型.    
  ExitInstance    
  该函数的缺省实现是把框架选项写入应用程序的.ini文件.重载该函数可在应用   程序终止时进行清理 工作 .    
  GetFirstDocTemplatePosition    
  获得应用程序注册的第一个文档模板的位置.利用该值来调用GetNextDocTemplate   并获得第一个CDocTemplate的指针.    
  GetNextDocTemplate    
  返回由pos标识的文档模板.如果程序员已经调用GetFirstDocTemplatePostion   建立了初始位置,则可以在向前迭代循环中使用GetNextDocTemplate.如果被检索的   文档模板是模板列表中最后一个.则pos参数被置为NULL    
  GetPrinterDeviceDefaults    
  为打印 准备 一个打印设备描述表.如果在当前程序会话中调用了PrintSetup,则   该成员函数使用用户最后一次设置的打印机配置;否则,它从WindowS的.ini文件中   获取当前的打印机配置.    
  GetProfileInt    
  从应用程序的.ini文件指定段的项中获取一个整数值(非在小写敏感).    
  GetProfileString    
  调用该成员函数检索与应用程序的.ini文件中指定段中的项相联系的字符串.    
  HideApplication    
  在关闭打开的文档之前,隐藏该应用程序.    
  InitInstance    
  Windows允许同一程序的几个实例同时运行.应用程序的初始化分为两种:首次   初始化,后继初始化.程序第一次运行时执行首次初始化.而当每次程序的拷贝运行   时,包括第一次,都将执行后继初始化.重载InitInstance以初始化在Windows下运   行的应用程序的每一个新实例.可以查看数据成员m_hPrevInstance的值,如果其值   为NULL,表示这是应用程序的第一次运行.    
  LoadCursor    
  装载由lpszResourceName命名或由nIDResource标识的光标资源.如果光标原先   未被装载,则LoadCursor以hit或"thunk"风格将光标装入内存.使用LoadStandardCursor   或LoadOEMCursor成员函数来访问预定义的Windows光标.    
  LoadIcon    
  从可执行文件中装载一个由lpszResourceName命名或由nIDResource标识的的   图标.如果图标原先未被装载,则LoadIcon用hit或"thunk"风格将图标装入内存.使用   LoadStandardIcon或LoadOEMIcon成员函数来访问预定义的Window图标.    
  LoadOEMCursor    
  装载由nIDCursor标识的Windows预定义的光标资源.    
  LoadOEMIcon    
  装载由nIDIcon标识的Windows预定义的光标资源.    
  LoadStandardCursor    
  装载由lpszCursorName标识的Windows预定义的光标资源.    
  LoadStandardIcon    
  装载一个预定义的图标资源    
  LoadStdProfileSettings    
  允许并装载最近使用的文件的数目.如果为0,表示没有MRU列表    
  OnContextHelp    
  该函数使应用程序进入帮助方式.光标此时变为一箭头-问号形状.用户可 移动   鼠标指针并按鼠标左键来选择一个对话框,窗口,菜单或命令按钮.OnContextHelp自   动获取光标下面的对象的上下文帮助,并使用该帮助描述表调用Window函数的WinHelp    
  OnDDECommand    
  当主框架窗口收到一个动态数据交换(DDE)的执行消息时调用该函数.其缺省   实现检查该命令是否请求打开一个文档,若文档存在则激活它.当用户在桌面上,文   件管理器或资源管理器中打开一个文档时,Windows   Shell通常发出一条DDE命令字   符串.也可以实现用该函数来处理其他DDE执行命令,如打印信念.    
  OnFileNew    
  执行file|New命令.在CWinApp类的消息映射表中必须包含ON_COMMAND(ID_FILE_   NEW,OnFileNew)语句,以便该函数正常工作.    
  OnFileOpen    
  执行file|Open命令.在CWinApp类的消息映射表中必须包含ON_COMMAND(ID_FILE_   OPEN,OnFileOpen)语句,以便该函数正常工作.    
  OnFilePrintSetup    
  执行file|Print命令.在CWinApp类的消息映射表中必须包含ON_COMMAND(ID_FILE_   PRINT,OnFilePrintSetup)语句,以便该函数正常工作.    
  OnHelp    
  确定对应当前窗口,对话框或菜单项的帮助上下文,然后调用WINHELP.EXE.如果   当前没有可用的上下文,则使用缺省的上下文CWinApp类消息映射表中加入ON_COMMAND   (ID_HELP,OnHelp)语句,以使该成员函数可用.你可以重载该成员函数来设置帮助上   下文,而不是使用上下文使用ID调用WinHelp的缺省实现.    
  OnHelpFinder    
  通过标准的HELP_FINDER主题激活WinHelp.在CWinApp类的消息映射中加入ON_   COMMAND(ON_HELP_FINDER,OnHelpFinder)语句,以使该成员函数可用.    
  OnHelpIndex    
  通过标准的HELP_INDEX主题激活WinHelp.在CWinApp类的消息映射中加入ON_   COMMAND(ON_HELP_INDEX,OnHelpIndex)语句,以使该成员函数可用.    
  OnHelpUsing    
  通过标准的HELP_HELPONHELP主题激活WinHelp.在CWinApp类的消息映射中加入ON_   COMMAND(ON_HELP_USING,OnHelpUsing)语句,以使该成员函数可用.    
  OnIdle    
  在缺省消息循环中调用OnIdle来执行空闲时的处理,直到应用程序的消息队列   为空.你可以重载该函数处理后台空闲任务.然而,不要处理需要耗费较长时间的任务,   因为只有在等OnIdle返回后才能处理用户的输入.同样还必须在重载函数中使用lCount   调用CWinApp::OnIdle.首先调用所有基类的空闲处理,直到基类的OnIdle返回0,OnIdle   返回0表示不需要空闲处理时间,基于这一点,程序员可以调用自己不同的空闲处理路径.    
  OpenDocumentFile    
  MFC框架调用该成员函数来打开CDocument文件.如果具有该名称的文档已经被打开,   则含有该文档的框窗口将被激活.如果应用程序支持多个文档模板,框架使用文件扩展名   来查找适当的文档模板,以试图装载该文档,并创建一个框架窗口和视.    
  ParseCommandLine    
  解析命令行并将每个参数传递给CCommandLineInfo::ParseParam.这个成员函数通   常在CWinApp派生类的InitInstance函数中被调用.调用该函数后,通常紧接着调用   ProcessShellCommand()函数.    
  PreTranslateMessage    
  将消息分发给Window函数TranslateMessage和DispatchMessage之前,过滤窗口消息.   因为该函数实现了加速键的翻译,所以程序员必须在重载该函数的代码中调用   CWinApp::PreTranslateMessage缺省实现成员函数.    
  ProcessMessageFilter    
  框架的钩子进程调用该成员函数来过滤和响应一个Window消息.钩子函数在事件被   发送给应用程序的普通消息处理之前处理这些事件.如果要重载该函数,则应在基类中调   用该函数的缺省实现.    
  ProcessShellCommand    
  被InitInstance调用,接收由rCmdInfo   CCommandLineInfo对象传递来的参数.处理   从命令行传来的界面命令如File|Open和File|Print.    
  ProcessWndProcException    
  每当处理程序不能捕获应用程序的消息或命令处理函数中发出的异常时,框架调用   该成员函数.如果该未捕获的异常源于一条菜单,工具条或加速键命令失败,则消息框显   示一条"Command   failed"消息,否则,显示一条"Internal   application   error"消息.    
  RegisterShellFileTypes    
  调用该成员函数以便用windows文件管理器注册所有文档类型。这将允许用户打开   有关数据文件（在文件管理器或资源管理器中双击该文件）它还允许用户直接从Shell   打印一个文件，或是将文件拖以打印机对象中。程序员应在为应用程序中创建的每个文   档模板调用了AddDocTemplate之后，调用RegisterShellFile。调用EnableShellOpen   成员函数打开Shell,以实现文件类型的注册。    
  Run    
  接收和发送Windows消息直到应用程序收到一条WM_QUIT消息为止。若应用程序的消   息队列中当前没有消息，由调用OnIdle来实现空闲时的处理。接收到的消息首先在   PreTranslateMessage函数中进行特殊处理，然后在Windows函数TranslateMessage中进   行加速键和键盘翻译，最后调用Windows函数DispatchMessage。    
  RunAutomated    
  调用该成员函数确定是否提供了/Automation或-Automation选项，该选项指出一个   客户应用程序是否启动了服务器应用程序。在设置命令行数据成员m_lpCmdLine之前，这   些选项已经从命令行中删除了。    
  RunEmbedded    
  调用该成员函数，确定是否提供了"/Embedding"或"-Embedding"选项。该选项指出   一个客户应用程序是否启动了服务器应用程序。在设置命令行数据成员m_lpCmdLine之   前，这些选项已经从命令行中删除了。    
  SaveAllModified    
  在主框架窗口关闭之前保佑所有文档。应用程序中所有属于已注册模板且被修改过的   文档将调用CDocument::SaveModified.    
  SelectPrinter    
  选定一个打印机。如果hDevModde和hDevNames的值均为NULL，则使用当前缺省的打印机    
  SetDialogBkColor    
  该函数为应用程序中的对话框和消息框设置缺省的背景颜色和文本颜色。该函数应该在   CWinApp派生类的InitInstance函数中调用。    
  SetRegistryKey    
  把应用程序的设置存储到注册表中，而不是.ini文件中。该函数设置m_WriteProfileInt   和WriteProfileString成员函数使用。    
  WinHelp    
  激活WinHelp。当应用程序终止时，框架会自动关闭应用程序 启动 的WinHelp实例。    
  WriteProfileInt    
  将指定段和值写入应用程序的.ini文件中。    
  WriteProfileString    
  调用该成员函数，将一个字符串写入应用程序.ini文件的某个段。