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”等将使用QObject::tr()在“QShortcut ”上下文中进行转换。

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

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

另请参阅 fromString()。

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)。

在某些情况下，此函数非常有用，例如当您希望将QKeySequence 对象用作QMap 中的键时。

另请参阅 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)

将other 通过Move操作赋值给该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 的元素的引用。此方法仅可用于读取元素。