QKeySequence Class

成员函数文档

QKeySequence::QKeySequence()

构造一个空键序列。

QKeySequence::QKeySequence(QKeySequence::StandardKey key)

为给定的key 构建一个 QKeySequence 对象。结果将取决于当前运行的平台。

生成的对象将基于key 的键绑定列表中的第一个元素。

QKeySequence::QKeySequence(const QString &key, QKeySequence::SequenceFormat format = NativeText)

根据format ，从key 字符串创建一个按键序列。

例如，"Ctrl+O "表示 CTRL+'O'。可识别字符串 "Ctrl"、"Shift"、"Alt "和 "Meta"，以及它们在 "QShortcut"上下文中的对应翻译（使用QObject::tr() ）。

最多可以输入四个按键代码，用逗号分隔，例如 "Alt+X,Ctrl+S,Q"。

该构造函数通常与tr() 一起使用，以便在翻译中替换快捷键：

QMenu *file = new QMenu(this);
file->addAction(tr("&Open..."), QKeySequence(tr("Ctrl+O", "File|Open")),
                this, &MainWindow::open);

请注意 "File|Open "翻译注释。这绝不是必要的，但它为人工翻译提供了一些上下文。

QKeySequence::QKeySequence(QKeyCombination k1, QKeyCombination k2 = QKeyCombination::fromCombined(0), QKeyCombination k3 = QKeyCombination::fromCombined(0), QKeyCombination k4 = QKeyCombination::fromCombined(0))

构建最多包含 4 个按键的按键序列k1,k2,k3 和k4 。

另请参见 QKeyCombination 。

QKeySequence::QKeySequence(int k1, int k2 = 0, int k3 = 0, int k4 = 0)

构建一个最多包含 4 个按键的按键序列k1,k2,k3 和k4 。

按键代码列于Qt::Key ，可与修饰符（见Qt::KeyboardModifier ）组合，如Qt::ShiftModifier,Qt::ControlModifier,Qt::AltModifier 或Qt::MetaModifier 。

QKeySequence::QKeySequence(const QKeySequence &keysequence)

复制构造函数。生成keysequence 的副本。

[noexcept] QKeySequence::~QKeySequence()

销毁按键序列。

int QKeySequence::count() const

返回按键序列中按键的数量。最多为 4 个。

[static] QKeySequence QKeySequence::fromString(const QString &str, QKeySequence::SequenceFormat format = PortableText)

根据format 从字符串str 返回QKeySequence 。

另请参阅 toString() 。

bool QKeySequence::isEmpty() const

如果键序列为空，则返回true ；否则返回 false。

[static] QList<QKeySequence> QKeySequence::keyBindings(QKeySequence::StandardKey key)

返回给定key 的按键绑定列表。调用此函数的结果将根据目标平台而有所不同。列表的第一个元素表示给定平台的主要快捷方式。如果结果中包含多个结果，则这些结果可视为给定key 在同一平台上的替代快捷方式。

[static] QList<QKeySequence> QKeySequence::listFromString(const QString &str, QKeySequence::SequenceFormat format = PortableText)

根据format 从字符串str 返回QKeySequence 的列表。

另请参阅 fromString() 和listToString()。

[static] QString QKeySequence::listToString(const QList<QKeySequence> &list, QKeySequence::SequenceFormat format = PortableText)

根据format 返回list 的字符串表示。

另请参阅 toString() 和listFromString()。

QKeySequence::SequenceMatch QKeySequence::matches(const QKeySequence &seq) const

将序列与seq 匹配。如果匹配成功，则返回ExactMatch ；如果seq 匹配不完全，则返回PartialMatch ；如果序列没有共同点，则返回NoMatch 。如果seq 更短，则返回NoMatch 。

[static] QKeySequence QKeySequence::mnemonic(const QString &text)

返回text 中助记符的快捷键序列，如果找不到助记符，则返回空键序列。

例如，mnemonic("E&xit") 返回Qt::ALT+Qt::Key_X ，mnemonic("&Quit") 返回ALT+Key_Q ，mnemonic("Quit") 返回空的QKeySequence 。

[noexcept] void QKeySequence::swap(QKeySequence &other)

将此键序列与other 互换。这一操作速度非常快，而且从未出现过故障。

QString QKeySequence::toString(QKeySequence::SequenceFormat format = PortableText) const

根据format 返回按键序列的字符串表示。

例如，值Qt::CTRL+Qt::Key_O 的结果是 "Ctrl+O"。如果按键序列有多个按键代码，则每个代码在返回的字符串中用逗号隔开，如 "Alt+X, Ctrl+Y, Z"。Ctrl"、"Shift "等字符串在 "QShortcut"上下文中使用QObject::tr() 进行翻译。

如果按键序列中没有按键，则返回空字符串。

在 Apple 平台上，如果format 是QKeySequence::NativeText ，返回的字符串与菜单栏中显示的序列相似；否则，字符串将使用 "可移植 "格式，适合写入文件。

另请参阅 fromString() 。

QVariant QKeySequence::operator QVariant() const

以QVariant

bool QKeySequence::operator!=(const QKeySequence &other) const

如果该键序列不等于other 键序列，则返回true ；否则返回false 。

bool QKeySequence::operator<(const QKeySequence &other) const

提供此密钥序列与other 密钥序列的任意比较。如果两个键序列相等，运算符返回false ；如果键序列不相等，运算符返回 (ks1 < ks2) == !( ks2 < ks1)。

该函数在某些情况下非常有用，例如，如果要在QMap 中使用QKeySequence 对象作为键。

另请参阅 operator==(),operator!=(),operator>(),operator<=() 和operator>=().

bool QKeySequence::operator<=(const QKeySequence &other) const

如果该关键字序列小于或等于other 关键字序列，则返回true ；否则返回false 。

另请参阅 operator==(),operator!=(),operator<(),operator>() 和operator>=() 。

[noexcept] QKeySequence &QKeySequence::operator=(QKeySequence &&other)

Move-assignsother 到此QKeySequence 实例。

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

赋值操作符。将other 键序列赋值给该对象。

bool QKeySequence::operator==(const QKeySequence &other) const

如果该键序列等于other 键序列，则返回true ；否则返回false 。

bool QKeySequence::operator>(const QKeySequence &other) const

如果该键序列大于other 键序列，则返回true ；否则返回false 。

另请参阅 operator==(),operator!=(),operator<(),operator<=() 和operator>=() 。

bool QKeySequence::operator>=(const QKeySequence &other) const

如果该关键字序列大于或等于other 关键字序列，则返回true ；否则返回false 。

另请参阅 operator==(),operator!=(),operator<(),operator>() 和operator<=() 。

QKeyCombination QKeySequence::operator[](uint index) const

返回键序列中index 位置元素的引用。这只能用于读取元素。