MFC解析启动命令行参数——CCommandLineInfo类

MFC中CCommandLineInfo类被用于分析启动应用时的命令行参数。

MFC应用一般都会在它的应用对象中使用函数InitInstance()创建这个类的一个本地实例。然后把该对象传给CWinApp::ParseCommandLine(),ParseCommandLine()又重复调用ParseParam()填充CCommandLineInfo对象。最后,CCommandLineInfo对象被传给CWinApp::ProcessShellCommand()来处理命令行参数和选项。所以我们会在App类InitInstance()函数中发现如下几行代码:

CCommandLineInfo cmdInfo;
ParseCommandLine(cmdInfo);

// Dispatch commands specified on the command line
if (!ProcessShellCommand(cmdInfo))
	return FALSE;

这几行代码是程序启动时创建新文档的关键代码。

1:我们首先来看看让CCommandLineInfo类的结构

//in afxwin.h
class CCommandLineInfo : public CObject
{
     public:
     // Sets default values
   CCommandLineInfo();
   BOOL m_bShowSplash;
   BOOL m_bRunEmbedded;
   BOOL m_bRunAutomated;
   enum { FileNew, FileOpen, FilePrint, FilePrintTo, FileDDE, AppRegister,
   AppUnregister, FileNothing = -1 } m_nShellCommand;
// not valid for FileNew
   CString m_strFileName;
   . . .
   ~CCommandLineInfo();
   . . .
};

这里要重点注意enum {FileNew, . . . , FileNothing = -1 } m_nShellCommand;

这里联合类型定义的m_nShellCommand 就是外壳程序执行的命令类型。如果m_nShellCommand设置为FileNew,那么程序就会创建新文档;如果想在文档开始时不创建新文档,就必须将m_nShellCommand设置为FilleNothing。

下面我们再看看CCommandLineInfo的构造函数:

//in appcore.cpp
CCommandLineInfo::CCommandLineInfo()
{
         m_bShowSplash   = TRUE;
         m_bRunEmbedded   = FALSE;
         m_bRunAutomated = FALSE;
         m_nShellCommand = FileNew;
}

这里很明白的看出,构造函数中,缺省将 m_nShellCommand设置为 FileNew。

2:再来看看ParseCommandLine(cmdInfo)函数

void CWinApp::ParseCommandLine(CCommandLineInfo& rCmdInfo)
{
     for (int i = 1; i < __argc; i++)   // extern int __argc;
     {
         LPCTSTR pszParam = __targv[i];   //extern char ** __argv;
                                            extern wchar_t ** __wargv;
                                            difine __targv   __wargv
         BOOL bFlag = FALSE;
         BOOL bLast = ((i + 1) == __argc);
         if (pszParam[0] == '-' || pszParam[0] == '/')
         {
             // remove flag specifier
             bFlag = TRUE;
             ++pszParam;
         }
         rCmdInfo.ParseParam(pszParam, bFlag, bLast);
     }
}

可以看出ParseCommandLine()主要是对输入的命令行参数做一些分析,并调用ParseParam()来进行处理。继续分析ParseParam()函数,查看如下源代码:

void CCommandLineInfo::ParseParam(const TCHAR* pszParam,BOOL bFlag,BOOL bLast)
{
     if (bFlag)
     {
         USES_CONVERSION;
         ParseParamFlag(T2CA(pszParam));
     }
     else
         ParseParamNotFlag(pszParam);
     ParseLast(bLast);
}

其它的函数撇开不看,我们重点来分析一下ParseParamFlag()和ParseLast()函数。

void CCommandLineInfo::ParseParamFlag(const char* pszParam)
{
     // OLE command switches are case insensitive, while
     // shell command switches are case sensitive
     if (lstrcmpA(pszParam, "pt") == 0)
         m_nShellCommand = FilePrintTo;
     else if (lstrcmpA(pszParam, "p") == 0)
         m_nShellCommand = FilePrint;
     else if (lstrcmpiA(pszParam, "Unregister") == 0 ||
             lstrcmpiA(pszParam, "Unregserver") == 0)
         m_nShellCommand = AppUnregister;
     else if (lstrcmpA(pszParam, "dde") == 0)
     {
         AfxOleSetUserCtrl(FALSE);
         m_nShellCommand = FileDDE;
     }
     else if (lstrcmpiA(pszParam, "Embedding") == 0)
     {
         AfxOleSetUserCtrl(FALSE);
         m_bRunEmbedded = TRUE;
         m_bShowSplash = FALSE;
     }
     else if (lstrcmpiA(pszParam, "Automation") == 0)
     {
         AfxOleSetUserCtrl(FALSE);
         m_bRunAutomated = TRUE;
         m_bShowSplash = FALSE;
     }
}

ParseParamFlag()判断传过来的字符串,判断它的参数类型,并根据参数类型做不同的处理。

void CCommandLineInfo::ParseLast(BOOL bLast)
{
     if (bLast)
     {
         if (m_nShellCommand == FileNew && !m_strFileName.IsEmpty())
             m_nShellCommand = FileOpen;
         m_bShowSplash = !m_bRunEmbedded && !m_bRunAutomated;
     }
}

ParseLast()会判断是否是是FileNew打开新文档,如果是打开新文档,并且打开的文档名不为空的话, 就假定用户想打开这个文档,把命令设置为FileOpen。

因此,我们可以总结一下函数ParseCommandLine()的作用:ParseCommandLine()的作用主要是分析命令行参数,如果没有命令行参数,ParseCommandLine()就假定用户想新建一个文档,于是设置一个FileNew命令;如果命令行参数中有一个文件名,ParseCommandLine()就假定用户想打开该文件,于是设置一个FileOpen命令。

3:接下来,我们来重点看看外壳命令解析的主角:ProcessShellCommand()

BOOL CWinApp::ProcessShellCommand(CCommandLineInfo& rCmdInfo)
{
       BOOL bResult = TRUE;
       switch (rCmdInfo.m_nShellCommand)
     {
           case CCommandLineInfo::FileNew:
                   if (!AfxGetApp()->OnCmdMsg(ID_FILE_NEW, 0, NULL, NULL))
                         OnFileNew();
                   if (m_pMainWnd == NULL)
                         bResult = FALSE;
                   break;
         case CCommandLineInfo::FileOpen:       . . .
         case CCommandLineInfo::FilePrintTo:     . . .
         case CCommandLineInfo::FilePrint:       . . .
         case CCommandLineInfo::FileDDE:       . . .
         case CCommandLineInfo::AppRegister:   . . .
         case CCommandLineInfo::AppUnregister: . . .
         . . .
       }
}

此函数如果成功地处理了外壳命令,则返回非零值,否则返回FALSE。代码看到这里,一切都很明白了。ProcessShellCommand()分析m_nShellCommand,并根据m_nShellCommand不同的类型值进行不同的处理。

4:最后,我们再来分析文章最初提到的App类InitInstance()函数中的几行代码。

1) 当CCommandLineInfo cmdInfo进行定义时,首先调用构造函数,构造函数中m_nShellCommand被设置为FileNew;

2) 然后执行ParseCommandLine(cmdInfo)对命令进行分析;

3) 最后调用ProcessShellCommand(cmdInfo)处理命令行参数和标志。ProcessShellCommand()判断m_nShellCommand为FileNew,于是调用OnFileNew()创建了一个新的文档。

这也就是创建新文档的来龙去脉。

如果我们希望应用程序启动时不默认打开空白文档,则应该:

CCommandLineInfo cmdInfo;
ParseCommandLine(cmdInfo);

if (cmdInfo.m_strFileName.IsEmpty())
{
	cmdInfo.m_nShellCommand = CCommandLineInfo::FileNothing;
}

if (!ProcessShellCommand(cmdInfo))
	return FALSE;

注意:这里很多网上给的解决方案都是

CCommandLineInfo cmdInfo;
cmdInfo.m_nShellCommand = CCommandLineInfo::FileNothing;
ParseCommandLine(cmdInfo);
if (!ProcessShellCommand(cmdInfo))
	return FALSE;

这样的做法运行起来貌似效果也相同,但是当用命令行或资源管理器调用应用程序执行时,就无法正常打开文档。因为不论青红皂白一律把m_nSellCommand设置为了FileNothing。

时间: 2024-10-12 21:39:19

MFC解析启动命令行参数——CCommandLineInfo类的相关文章

第8章2节《MonkeyRunner源码剖析》MonkeyRunner启动运行过程-解析处理命令行参数

MonkeyRunnerStarter是MonkeyRunner启动时的入口类,因为它里面包含了main方法.它的整个启动过程主要做了以下几件事情: 解析用户启动MonkeyRunner时从命令行传输进来的参数: 因为MonkeyRunner需要根据指定的参数才能做事情,比如输入的一个需要执行的脚本.如果确实不知道任何参数的话它就会进入MonkeyRunner的交互模式,其实就是Jythong的交互模式,让用户可以边写代码边执行 启动AndroidDebugBridge: 其实就是启动ADB服务

【Python】 配置解析ConfigParser &amp; 命令行参数解析optparser

ConfigParser ConfigParser包装了配置文件的读取和写入,使得python程序可以更加轻松操作配置文件了.这里的配置文件是指.ini的那种文件,基本格式如下 [section_a] a_key1 = a_value1 a_key2 = a_value2 [section_b] b_key1 = b_value1 b_key2 = b_value2 b_key3 = b_value3 将一个文件分隔成几个section,每个section中又有很多键值对,以这样的方式构建起配置

PHP 命令行参数解析工具类

<?php /** * 命令行参数解析工具类 * @author guolinchao */ class CommandLine { // 临时记录短选项的选项值 private static $shortOptVal = null; // options value private static $optsArr = array(); // command args private static $argsArr = array(); // 是否已解析过命令行参数 private static

3.QT中QCommandLineParser和QCommandLineOption解析命令行参数

 1  新建项目 main.cpp #include <QCoreApplication> #include <QCommandLineParser> #include <QDebug> #include <stdio.h> int main(int argc, char** argv) { QCoreApplication app(argc, argv); app.setApplicationVersion("1.0.0.0");

第5章4节《MonkeyRunner源码剖析》Monkey原理分析-启动运行: 命令行参数解析(原创)

天地会珠海分舵注:本来这一系列是准备出一本书的,详情请见早前博文"寻求合作伙伴编写<深入理解 MonkeyRunner>书籍".但因为诸多原因,没有如愿.所以这里把草稿分享出来,所以错误在所难免.有需要的就参考下吧,转发的话还请保留每篇文章结尾的出处等信息. 设置好Monkey的CLASSPATH环境变量以指定"/system/framework /framework/monkey.jar"后,/system/bin/monkey这个shell脚本就会通

C#命令行参数解析类以及使用实例

http://blog.csdn.net/jackxinxu2100/article/details/6642694 编写命令行程序时如何进行命令行参数解析至关重要,下面将引用codeproject里面的一个命令行参数解析类并阐述如何使用来说明C#命令行参数解析的过程. 先看参数解析类,分为CommandLine类以及CommandArgs类,前者负责解析,后者负责结果封装,解析的结果分为三类:即 a=b 对应的key/value类型,-a b 对应的option与option value(可省

用Google的gflags轻松的编码解析命令行参数

支持的参数类型 gflags支持的类型有bool,int32,int64,uint64,double和string.可以说这些基本类型大体上满足了我们的需求. DEFINE_bool: boolean DEFINE_int32: 32-bit integer DEFINE_int64: 64-bit integer DEFINE_uint64: unsigned 64-bit integer DEFINE_double: double DEFINE_string: C++ string 比如上文

解析命令行参数的方法

一.关于解析命令行参数的方法 关于"解析命令行参数"的方法我们一般都会用到sys.argv跟optparse模块.关于sys.argv,网上有一篇非常优秀的博客已经介绍的很详细了,大家可以去这里参考:https://www.cnblogs.com/aland-1415/p/6613449.html 这里为大家介绍一个比sys.argv更强大的optparse模块. 这里说一句题外话,点开optparse的源码,第一行注释是这样的:A powerful, extensible, and

【Python 命令行参数解析: optparse 模块】

大家在使用Python进行脚本开发时,经常需要通过终端交互的方式对Python的脚本模块进行调用.这时在 Python模块中提供基础的命令行参数支持是必不可少的.那么,在Python中我们如何实现命令行参数的传入和解析呢,如下内容将对此进行简要的介绍. Python对命令行参数解析的支持 Python中通过两个内建模块对命令行参数解析进行支持:getopt 和 optparse 两种内置支持 模块名 功能说明 getopt 对命令行参数进行简单的处理 optparse 能够对命令行参数进行复杂的