QKeySequence 类

成员函数文档

QKeySequence::QKeySequence()

构造一个空的键序列。

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

基于key字符串，根据format创建键序列。

例如，“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);

注意“文件|打开”翻译者注释。这绝对不是必要的，但它为人类翻译者提供了一些上下文。

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(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(QKeySequence::StandardKey key)

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

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

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在同一平台上的替代快捷方式。

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

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

参阅fromString() 和 listToString()。

[静态] 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。

[静态] QKeySequence QKeySequence::mnemonic(const QString &text)

返回 text 中快捷键序列的快捷键，如果没有找到快捷键则返回空快捷键序列。

例如，mnemonic("E&退出") 返回 Qt::ALT+Qt::Key_X，mnemonic("&退出") 返回 ALT+Key_Q，mnemonic("退出") 返回空的 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)。

在某些情况下此函数很有用，例如，如果您想使用 QKeySequence 对象作为 QMap 中的键。

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

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

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

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

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

赋值运算符。将 other 键序列赋给此对象。

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

将 other 移赋给此 QKeySequence 实例。

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的元素的引用。此操作只能用于读取元素。