Qt QCommandLineOption类


QCmandLineOption类定义了可能的命令行选项

头文件:

#include <QCmandLineOption>

cmake:

find_package(Qt6 CPONENTS Core REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Core)

qmake:

QT += core

引入:

Qt 5.2

详细说明

该类用于描述命令行上的选项。它允许用不同的方式定义同一个选项,并可能使用多个别名。它也用于描述如何使用选项它可以是一个标志(例如v)或一个值(例如o file)。

例子:

1 QCmandLineOption verboseOption("verbose", "Verbose mode. Prints out more information."); 2 QCmandLineOption outputOption(QStringList() << "o" << "output", "Write generated data into <file>.", "file");

公开类型

成员函数

QCmandLineOption

QCmandLineOption::QCmandLineOption(const QCmandLineOption &other)

构造一个QCmandLineOption对象,该对象是QCmandLineOption对象other的副本。

参见操作符 operator=().。

QCmandLineOption::QCmandLineOption(const QStringList &names, const QString &description, const QString &valueName = QString(), const QString &defaultValue = QString())

使用给定的参数构造一个命令行选项对象。

此重载允许为选项设置多个名称,例如o和output。

选项的名称设置为names。名字可以短也可以长。列表中长度为一个字符的任何名称都是短名称。选项名称不能为空,不能以破折号或斜杠开头,不能包含=并且不能重复。

描述设置为description。通常在描述的最后加上一个“.”。

此外,如果该选项需要一个值,则需要设置valueName。该选项的默认值设置为defaultValue。

在5.4之前的Qt版本中,这个构造函数是explicit的。它不再是并且可以用于C ++ 11样式的统一初始化:

1 QCmandLineParser parser; 2 parser.addOption(, "Write generated data into <file>.", "file"});

另请参见setDescription(),setValueName()和setDefaultValues()。

QCmandLineOption::QCmandLineOption(const QString &name, const QString &description, const QString &valueName = QString(), const QString &defaultValue = QString())

使用给定的参数构造一个命令行选项对象。

此重载允许为选项设置多个名称,例如o和output。

选项的名称设置为names。名字可以短也可以长。列表中长度为一个字符的任何名称都是短名称。选项名称不能为空,不能以破折号或斜杠开头,不能包含=并且不能重复。

描述设置为description。通常在描述的最后加上一个“.”。

此外,如果该选项需要一个值,则需要设置valueName。该选项的默认值设置为defaultValue。

在5.4之前的Qt版本中,这个构造函数是explicit的。它不再是并且可以用于C ++ 11样式的统一初始化:

1 QCmandLineParser parser; 2 parser.addOption();

另请参见setDescription(),setValueName()和setDefaultValues()。

QCmandLineOption::QCmandLineOption(const QStringList &names)

构造一个具有名称的命令行选项对象。

这个重载允许为选项设置多个名称,例如o和output。

名字可以短也可以长。列表中长度为一个字符的任何名称都是短名称。选项名称不能为空,不能以破折号或斜杠开头,不能包含=并且不能重复。

请参阅setDescription(), setValueName(),和setDefaultValues()。

QCmandLineOption::QCmandLineOption(const QString &name)

构造名称为name的命令行选项对象。

名称可以短也可以长。如果名称长度为一个字符,则认为它是一个短名称。选项名称不能为空,不能以破折号或斜杠开头,不能包含=并且不能重复。

请参阅setDescription(), setValueName(),和setDefaultValues()。

operator=

[since 5.2]
QCmandLineOption &QCmandLineOption::operator=(QCmandLineOption &&other)

移动其他对象到此QCmandLineOption实例。

此功能是在Qt 5.2中引入的。

QCmandLineOption &QCmandLineOption::operator=(const QCmandLineOption &other)

制作另一个对象的副本,并将其分配给此QCmandLineOption对象。

~QCmandLineOption

QCmandLineOption::~QCmandLineOption()

销毁命令行选项对象。

defaultValues

QStringList QCmandLineOption::defaultValues() const

返回为此选项设置的默认值。

参见setDefaultValues()。

description

QString QCmandLineOption::description() const

返回此选项的描述集。

参见setDescription()。

flags

[since 5.8]QCmandLineOption::Flags QCmandLineOption::flags() const

返回一组影响此命令行选项的标志。

这个函数是在Qt 5.8中引入的。

参见setFlags()和QCmandLineOption::Flags。

names

QStringList QCmandLineOption::names() const

返回为此选项设置的名称。

setDefaultValue

void QCmandLineOption::setDefaultValue(const QString &defaultValue)

将此选项的默认值设置为defaultValue。

如果应用程序的用户没有在命令行上指定该选项,则使用默认值。

如果defaultValue为空,则该选项没有缺省值。

请参阅defaultValues()和setDefaultValues()。

void QCmandLineOption::setDefaultValues(const QStringList &defaultValues)

将此选项使用的默认值列表设置为defaultValues。

如果应用程序的用户没有在命令行上指定该选项,则使用默认值。

请参阅defaultValues()和setDefaultValue()。

setDescription

void QCmandLineOption::setDescription(const QString &description)

将用于此选项的描述设置为description。

习惯上,在描述的最后加上一个“.”。

该描述由QCmandLineParser::showHelp()使用。

参见描述()。

setFlags

[since 5.8]void QCmandLineOption::setFlags(QCmandLineOption::Flags flags)

将影响此命令行选项的标志设置为flags。

这个函数是在Qt 5.8中引入的。

参见flags()和QCmandLineOption:: flags。

setValueName

void QCmandLineOption::setValueName(const QString &valueName)

将文档的期望值的名称设置为valueName。

没有分配值的选项具有类似布尔的行为:用户指定–option或不指定。

分配了值的选项需要为期望值设置名称,以便在帮助输出中记录该选项。名称为o和output且值名称为的选项file将显示为o, output 。

如果您希望该选项仅出现一次,则调用QCmandLineParser :: value();如果您希望该选项多次出现,则调用QCmandLineParser :: values()。

另请参见valueName()。

swap

void QCmandLineOption::swap(QCmandLineOption &other)

使用此选项交换其他选项。此操作非常快,并且永远不会失败。

valueName

QString QCmandLineOption::valueName() const

返回期望值的名称。

如果为空,则该选项不接受值。

参见setValueName()。



上一篇:Qt 通过ADS实现Beckhoff倍福TwinCAT通信

下一篇:Beckhoff EL7031模块参数设置


Qt
Copyright © 2002-2019 k262电脑网 www.k262.cn 皖ICP备2020016292号
温馨提示:部分文章图片数据来源与网络,仅供参考!版权归原作者所有,如有侵权请联系删除!QQ:251442993 热门搜索 网站地图