class QKeySequence链接到此处

《a class="reference internal" href="#PySide6.QtGui.QKeySequence" title="PySide6.QtGui.QKeySequence">QKeySequence类封装了用于快捷键的按键序列。 更多…

概要链接到此处

方法链接到此处

静态函数链接到此处

注意

本文档可能包含自动从C++转换为Python的风险片段。我们总是欢迎对片段翻译的贡献。如果您发现翻译有问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建票据来通知我们。

详细描述#

警告

本节包含自动从C++转换为Python的片段，可能包含错误。

最常见的键序列形式是，键序列描述了一系列必须一起使用的键来进行某些操作。键序列通常与QAction对象一起使用，以指定哪些键盘快捷键可以用来触发动作。

键序列可以通过以下三种方式构建，用作键盘快捷键：

  • 对于标准快捷键，可以使用一个standard key来请求与每个快捷键关联的平台特定键序列。

  • 对于自定义快捷键，可以使用“Ctrl+X”这样的人可读字符串，这些可以被翻译成不同语言用户的适当快捷键。翻译发生在“QShortcut”的上下文中。

  • 对于硬编码的快捷键，可以使用Qt::Key和Qt::KeyboardModifier枚举值定义的值组合来指定整数按键代码。每个按键代码由一个Qt::Key值和零个或多个修饰符组成，例如Qt::ShiftModifier、Qt::ControlModifier、Qt::AltModifier和Qt::MetaModifier。

例如，Ctrl P可能是一个用作打印文档快捷键的序列，可以用以下任何一种方式指定

QKeySequence(QKeySequence.Print)
QKeySequence(tr("Ctrl+P"))
QKeySequence(tr("Ctrl+p"))
QKeySequence(Qt.CTRL | Qt.Key_P)
QKeySequence(Qt.CTRL + Qt.Key_P) # deprecated

请注意，对于字母，指定字符串中使用的字母大小写不重要。在上面的例子中，用户不需要按住Shift键以激活用“Ctrl+P”指定的快捷键。然而，对于其他键，Shift作为未指定的额外修饰符键的使用可能会引起使用开发者使用的键盘布局与用户键盘布局不同的应用程序用户的困惑。请参阅下面的《键盘布局问题》部分以了解更多细节。

尽可能使用标准快捷键。在创建非标准快捷键的键序列时，应优先使用人可读字符串，而不是硬编码的整数值。

QKeySequence 对象可以被转换为 QString，获得序列的人类可读翻译版本。同样，toString() 函数生成用于菜单的人类可读字符串。在 Apple 平台上，使用 Macintosh 键盘上的特殊键来描述键盘快捷键时，会使用适当的符号。

指定硬编码键代码的另一种方法是使用字符的 Unicode 码点；例如，'A' 给出与 Qt::Key_A 相同的键序列。

注意

在 Apple 平台上，“Ctrl”、Qt::CTRL、Qt::Key_Control 和 Qt::ControlModifier 的引用对应于 Macintosh 键盘上的 Command 键，而“Meta”、Qt::META、Qt::Key_Meta 和 Qt::MetaModifier 的引用对应于 Control 键。因此，开发者可以在所有平台上使用相同的快捷键描述，并且它们的应用程序将在 Apple 平台上自动按预期工作。

标准快捷键#

QKeySequence 定义了许多 标准 键盘 快捷键，以降低在典型应用程序中设置操作所需的努力。下表显示了在四个广泛使用的平台上，应用程序通常用于这些标准快捷键的一些常见键序列。请注意，在 Apple 平台上，Ctrl 值对应于 Macintosh 键盘上的 Command 键，Meta 值对应于 Control 键。

StandardKey

Windows

Apple 平台

KDE Plasma

GNOME

HelpContents

F1

Ctrl+?

F1

F1

WhatsThis

Shift+F1

Shift+F1

Shift+F1

Shift+F1

Open

Ctrl+O

Ctrl+O

Ctrl+O

Ctrl+O

Close

Ctrl+F4, Ctrl+W

Ctrl+W, Ctrl+F4

Ctrl+W

Ctrl+W

Save

Ctrl+S

Ctrl+S

Ctrl+S

Ctrl+S

Quit

Ctrl+Q

Ctrl+Q

Ctrl+Q

SaveAs

Ctrl+Shift+S

Ctrl+Shift+S

Ctrl+Shift+S

Ctrl+Shift+S

New

Ctrl+N

Ctrl+N

Ctrl+N

Ctrl+N

Delete

Del

Forward Delete, Meta+D

Del, Ctrl+D

Del, Ctrl+D

Cut

Ctrl+X, Shift+Del

Ctrl+X, Meta+K

Ctrl+X, F20, Shift+Del

Ctrl+X, F20, Shift+Del

Copy

Ctrl+C, Ctrl+Ins

Ctrl+C

Ctrl+C, F16, Ctrl+Ins

Ctrl+C, F16, Ctrl+Ins

Paste

Ctrl+V, Shift+Ins

Ctrl+V, Meta+Y

Ctrl+V, F18, Shift+Ins

Ctrl+V, F18, Shift+Ins

Preferences

Ctrl+,

Undo

Ctrl+Z, Alt+Backspace

Ctrl+Z

Ctrl+Z, F14

Ctrl+Z, F14

Redo

Ctrl+Y, Shift+Ctrl+Z, Alt+Shift+Backspace

Ctrl+Shift+Z

Ctrl+Shift+Z

Ctrl+Shift+Z

Back

Alt+Left, Backspace

Ctrl+[

Alt+Left

Alt+Left

Forward

Alt+Right, Shift+Backspace

Ctrl+]

Alt+Right

Alt+Right

Refresh

F5

F5

F5

Ctrl+R, F5

ZoomIn

Ctrl+Plus

Ctrl+Plus

Ctrl+Plus

Ctrl+Plus

ZoomOut

Ctrl+Minus

Ctrl+Minus

Ctrl+Minus

Ctrl+Minus

FullScreen

F11, Alt+Enter

Ctrl+Meta+F

F11, Ctrl+Shift+F

Ctrl+F11

Print

Ctrl+P

Ctrl+P

Ctrl+P

Ctrl+P

AddTab

Ctrl+T

Ctrl+T

Ctrl+Shift+N, Ctrl+T

Ctrl+T

NextChild

Ctrl+Tab, Forward, Ctrl+F6

Ctrl+}, Forward, Ctrl+Tab

Ctrl+Tab, Forward, Ctrl+Comma

Ctrl+Tab, Forward

PreviousChild

Ctrl+Shift+Tab, Back, Ctrl+Shift+F6

Ctrl+{, Back, Ctrl+Shift+Tab

Ctrl+Shift+Tab, Back, Ctrl+Period

Ctrl+Shift+Tab, Back

Find

Ctrl+F

Ctrl+F

Ctrl+F

Ctrl+F

FindNext

F3, Ctrl+G

Ctrl+G

F3

Ctrl+G, F3

FindPrevious

Shift+F3, Ctrl+Shift+G

Ctrl+Shift+G

Shift+F3

Ctrl+Shift+G, Shift+F3

Replace

Ctrl+H

(无)

Ctrl+R

Ctrl+H

SelectAll

Ctrl+A

Ctrl+A

Ctrl+A

Ctrl+A

Deselect

Ctrl+Shift+A

Ctrl+Shift+A

Bold

Ctrl+B

Ctrl+B

Ctrl+B

Ctrl+B

Italic

Ctrl+I

Ctrl+I

Ctrl+I

Ctrl+I

Underline

Ctrl+U

Ctrl+U

Ctrl+U

Ctrl+U

MoveToNextChar

正确

正确，按Meta然后F

正确

正确

移动到前一个字符

左键

左键，按Meta然后B

左键

左键

移动到下一个单词

按Ctrl然后右键

Alt+Right

按Ctrl然后右键

按Ctrl然后右键

移动到前一个单词

按Ctrl然后左键

Alt+Left

按Ctrl然后左键

按Ctrl然后左键

移动到下一行

向下

向下，按Meta然后N

向下

向下

移动到前一行

向上

向上，按Meta然后P

向上

向上

移动到下一页

页下键

页下键，按Alt然后页下键，按Meta然后向下，按Meta然后页下键，按Meta然后V

页下键

页下键

移动到前一个页

页上键

页上键，按Alt然后页上键，按Meta然后向上，按Meta然后页上键

页上键

页上键

移动到行的开头

Home键

按Ctrl然后左键，按Meta然后左键

Home键

Home键

移动到行的末尾

End键

按Ctrl然后右键，按Meta然后右键

End键，按 Ctrl+E

End键，按 Ctrl+E

移动到文本区段的开头

(无)

按Alt然后向上，按Meta然后A

(无)

(无)

移动到文本区段的末尾

(无)

按Alt然后向下，按Meta然后E

(无)

(无)

移动到文档的开头

按Ctrl然后Home

按Ctrl然后向上，按Home

按Ctrl然后Home

按Ctrl然后Home

移动到文档的末尾

按Ctrl然后End

按Ctrl然后向下，按End

按Ctrl然后End

按Ctrl然后End

选择下一个字符

按Shift然后右键

按Shift然后右键

按Shift然后右键

按Shift然后右键

选择前一个字符

按Shift然后左键

按Shift然后左键

按Shift然后左键

按Shift然后左键

选择下一个单词

按Ctrl然后Shift然后右键

按Alt然后Shift然后右键

按Ctrl然后Shift然后右键

按Ctrl然后Shift然后右键

选择前一个单词

按Ctrl然后Shift然后左键

按Alt然后Shift然后左键

按Ctrl然后Shift然后左键

按Ctrl然后Shift然后左键

选择下一行

按Shift然后向下

按Shift然后向下

按Shift然后向下

按Shift然后向下

选择前一行

按Shift然后向上

按Shift然后向上

按Shift然后向上

按Shift然后向上

选择下一页

按Shift然后页下键

按Shift然后页下键

按Shift然后页下键

按Shift然后页下键

选择前一个页

按Shift然后页上键

按Shift然后页上键

按Shift然后页上键

按Shift然后页上键

选择行的开头

按Shift然后Home

按Ctrl然后Shift然后左键

按Shift然后Home

按Shift然后Home

选择行的末尾

按Shift然后End

按Ctrl然后Shift然后右键

按Shift然后End

按Shift然后End

选择文本区段的开头

(无)

按Alt然后Shift然后向上，按Meta然后Shift然后A

(无)

(无)

选择文本区段的末尾

(无)

按Alt然后Shift然后向下，按Meta然后Shift然后E

(无)

(无)

选择文档的开头

按Ctrl然后Shift然后Home

按Ctrl然后Shift然后向上，按Shift然后Home

按Ctrl然后Shift然后Home

按Ctrl然后Shift然后Home

选择文档的末尾

按Ctrl然后Shift然后End

按Ctrl然后Shift然后向下，按Shift然后End

按Ctrl然后Shift然后End

按Ctrl然后Shift然后End

删除单词的开头

按Ctrl然后退格键

按Alt然后退格键

按Ctrl然后退格键

按Ctrl然后退格键

删除单词的末尾

按Ctrl然后删除键

(无)

按Ctrl然后删除键

按Ctrl然后删除键

删除行的末尾

(无)

(无)

按Ctrl然后K

按Ctrl然后K

删除整行

(无)

(无)

Ctrl+U

Ctrl+U

插入段落分隔符

按Enter

按Enter

按Enter

按Enter

插入行分隔符

按Shift然后Enter

按Meta然后Enter，按Meta然后O

按Shift然后Enter

按Shift然后Enter

退格键

(无)

删除，按Meta然后H

(无)

(无)

取消

Esc键

Esc键，按 Ctrl+.

Esc键

Esc键

注意，由于不同平台的标准快捷键使用的键序列不同，您仍需要在每个平台上测试您的快捷键以确保您没有意外地将相同的键序列分配给多个操作。

键盘布局问题链接到本标题

许多键序列的指定是由开发者根据某些类型键盘的布局选择的，而不是选择代表行动名称第一个字母的键，例如Ctrl S（"Ctrl+S"）或Ctrl C（"Ctrl+C"）。此外，由于某些符号只能在使用某些键盘布局时通过修饰键输入，因此旨在用于一种键盘布局的键序列可能映射到不同的键，没有键对应，或在不同键盘布局上需要使用额外的修饰键。

例如，快捷键Ctrl加上和Ctrl减去通常用作图形应用程序中缩放操作的快捷键，分别指定为“Ctrl++”和“Ctrl+-”。然而，这些快捷键的指定和解释取决于键盘布局。挪威键盘的用户会注意到加号和减号键在键盘上不相邻，但他们仍然可以无需按Shift键就激活这两个快捷键。然而，使用英国键盘的用户需要按住Shift键才能输入加号符号，这使得快捷键实际上等同于“Ctrl+Shift+=”。

尽管一些开发者可能会求助于完全指定他们在键盘上用于激活快捷键的所有修饰键，但这也会导致使用不同键盘布局的用户遇到意外的行为。

例如，使用英式键盘的开发者可能会选择指定“Ctrl+Shift+=”作为快捷键序列，以创建一个意外地与Ctrl +具有相同行为的快捷键。然而，在挪威键盘上，必须使用Shift键才能访问等号键，这使得所需的快捷键实际上变成了Ctrl Shift Shift =（一个不可能的按键组合）。

因此，当指定可以在各种不同键盘布局上使用的键序列时，可读性好的字符串和硬编码的键码都可能存在使用上的问题。只有使用标准 快捷键，才能保证用户能够使用开发者意图中的快捷键。

尽管如此，我们可以通过确保使用可读性好的字符串来解决此问题，这样就可以为不同语言的用户提供键序列的翻译。对于键盘布局与所使用语言中最典型的布局相匹配的用户，这种方法将取得成功。

GNU Emacs 风格的键序列#

可以使用多个参数构造函数或通过传递以逗号分隔的、可读性好的键序列字符串，创建类似于在GNU Emacs 中使用的键序列，允许最多四个键码。

例如，键序列Ctrl X 后跟 Ctrl C，可以通过以下两种方式之一指定：

QKeySequence(tr("Ctrl+X, Ctrl+C"))
QKeySequence(Qt.CTRL | Qt.Key_X, Qt.CTRL | Qt.Key_C)
QKeySequence(Qt.CTRL + Qt.Key_X, Qt.CTRL + Qt.Key_C) # deprecated

警告

在创建QKeySequence之前，必须构建QApplication 的实例；否则，您的应用程序可能会崩溃。

参见

QShortcut

class StandardKey#

此枚举表示标准键绑定。它们可以用于将平台相关键盘快捷键分配给QAction。

请注意，键绑定是平台相关的。可以通过使用keyBindings() 查询当前绑定的快捷键。

常量

描述

QKeySequence.AddTab

添加新标签。

QKeySequence.Back

后退。

QKeySequence.Backspace

删除前一个字符。

QKeySequence.Bold

加粗文本。

QKeySequence.Close

关闭文档/标签。

QKeySequence.Copy

复制。

QKeySequence.Cut

剪切。

QKeySequence.Delete

删除。

QKeySequence.DeleteEndOfLine

删除行尾。

QKeySequence.DeleteEndOfWord

从光标末尾删除单词。

QKeySequence.DeleteStartOfWord

删除从光标到单词开头的内容。

QKeySequence.DeleteCompleteLine

删除整行。

QKeySequence.Find

在文档中查找。

QKeySequence.FindNext

查找下一个结果。

QKeySequence.FindPrevious

查找上一个结果。

QKeySequence.Forward

前进。

QKeySequence.HelpContents

打开帮助内容。

QKeySequence.InsertLineSeparator

插入新行。

QKeySequence.InsertParagraphSeparator

插入新段落。

QKeySequence.Italic

斜体文本。

QKeySequence.MoveToEndOfBlock

将光标移动到块末尾。此快捷键仅在Apple平台上使用。

QKeySequence.MoveToEndOfDocument

将光标移动到文档末尾。

QKeySequence.MoveToEndOfLine

将光标移动到行末。

QKeySequence.MoveToNextChar

将光标移动到下一个字符。

QKeySequence.MoveToNextLine

将光标移动到下一行。

QKeySequence.MoveToNextPage

将光标移动到下一页。

QKeySequence.MoveToNextWord

将光标移动到下一个单词。

QKeySequence.MoveToPreviousChar

将光标移动到上一个字符。

QKeySequence.MoveToPreviousLine

将光标移动到上一行。

QKeySequence.MoveToPreviousPage

将光标移动到上一页。

QKeySequence.MoveToPreviousWord

将光标移动到上一个单词。

QKeySequence.MoveToStartOfBlock

将光标移动到文本块开始处。此快捷方式仅在苹果平台上使用。

QKeySequence.MoveToStartOfDocument

将光标移动到文档开始处。

QKeySequence.MoveToStartOfLine

将光标移动到行开始处。

QKeySequence.New

创建新文档。

QKeySequence.NextChild

导航到下一个选项卡或子窗口。

QKeySequence.Open

打开文档。

QKeySequence.Paste

粘贴。

QKeySequence.Preferences

打开首选项对话框。

QKeySequence.PreviousChild

导航到上一个选项卡或子窗口。

QKeySequence.Print

打印文档。

QKeySequence.Quit

退出应用程序。

QKeySequence.Redo

重做。

QKeySequence.Refresh

刷新或重新加载当前文档。

QKeySequence.Replace

查找和替换。

QKeySequence.SaveAs

在提示用户输入文件名后保存文档。

QKeySequence.Save

保存文档。

QKeySequence.SelectAll

选择所有文本。

QKeySequence.Deselect

取消选择文本。自5.1版起

QKeySequence.SelectEndOfBlock

扩展选择到文本块的末尾。此快捷方式仅在苹果平台上使用。

QKeySequence.SelectEndOfDocument

扩展选择到文档末尾。

QKeySequence.SelectEndOfLine

扩展选择到行末。

QKeySequence.SelectNextChar

扩展选择到下一个字符。

QKeySequence.SelectNextLine

扩展选择到下一行。

QKeySequence.SelectNextPage

扩展选择到下一页。

QKeySequence.SelectNextWord

扩展选择到下一个单词。

QKeySequence.SelectPreviousChar

扩展选择到前一个字符。

QKeySequence.SelectPreviousLine

扩展选择到上一行。

QKeySequence.SelectPreviousPage

扩展选择到上一页。

QKeySequence.SelectPreviousWord

扩展选择到前一个单词。

QKeySequence.SelectStartOfBlock

扩展选择到文本块开头。此快捷方式仅在苹果平台上使用。

QKeySequence.SelectStartOfDocument

扩展选择到文档开头。

QKeySequence.SelectStartOfLine

扩展选择到行开头。

QKeySequence.Underline

加下划线。

QKeySequence.Undo

撤销。

QKeySequence.UnknownKey

未绑定键。

QKeySequence.WhatsThis

激活“这是什么”。

QKeySequence.ZoomIn

放大。

QKeySequence.ZoomOut

缩小。

QKeySequence.FullScreen

切换窗口状态为全屏/非全屏。

QKeySequence.Cancel

取消当前操作。
class SequenceFormat#

常量

描述

QKeySequence.NativeText

将键序列作为特定平台的字符串。这意味着它将显示为翻译后的内容，在苹果平台上它将类似于菜单栏中的快捷方式序列。此枚举最好用于显示字符串给用户。

QKeySequence.PortableText

键序列以“可移植”的格式给出，适合读取和写入文件。在很多情况下，它将类似于Windows和X11上的本地文本。
class SequenceMatch#

常量

描述

QKeySequence.NoMatch

键序列不同；甚至不部分匹配。

QKeySequence.PartialMatch

键序列部分匹配，但不同。

QKeySequence.ExactMatch

键序列相同。
__init__(k1[, k2=QKeyCombination.fromCombined(0)[, k3=QKeyCombination.fromCombined(0)[, k4=QKeyCombination.fromCombined(0)]]])#
参数：

使用最多4个键 k1、k2、k3 和 k4 构造一个键序列。

__init__(key)
参数：

key – StandardKey

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

结果对象将基于键的键绑定列表中的第一个元素。

__init__(ks)
参数：

ks – QKeySequence

拷贝构造函数。复制了 keysequence。

__init__(key[, format=QKeySequence.SequenceFormat.NativeText])
参数：

警告

本节包含自动从C++转换为Python的片段，可能包含错误。

基于 format 从 key 字符串创建一个键序列。

例如，“Ctrl+O”给出 CTRL+'O'。字符串“Ctrl”、“Shift”、“Alt”和“Meta”被识别，以及它们的“ QShortcut ”上下文中的翻译等效项（使用 QObject::tr（））。

可以通过逗号分隔最多输入四个键码，例如“Alt+X,Ctrl+S,Q”。

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

file = QMenu(self)
file.addAction(tr("Open..."), QKeySequence(tr("Ctrl+O", "File|Open")),
                self.open)

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

__init__(k1[, k2=0[, k3=0[, k4=0]]])
参数：

  • k1 – int

  • k2 – int

  • k3 – int

  • k4 – int

使用最多4个键 k1、k2、k3 和 k4 构造一个键序列。

键码列在Qt::Key中，可以与修饰符（见Qt::KeyboardModifier）结合使用，如Qt::ShiftModifier，Qt::ControlModifier，Qt::AltModifier或Qt::MetaModifier。

__init__()

构建一个空的键序列。

__getitem__()#
__reduce__()#
返回类型：:

对象

__repr__()#
返回类型：:

对象

count()#
返回类型：:

int

返回键序列中的键的数量。最大为4。

static fromString(str[, format=QKeySequence.SequenceFormat.PortableText])#
参数：
返回类型：:

QKeySequence

基于字符串 str 和 format 返回一个 QKeySequence。

参见

toString()

isEmpty()#
返回类型：:

bool

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

static keyBindings(key)#
参数：

key – StandardKey

返回类型：:

. QKeySequence 列表

返回给定 key 的键绑定列表。该函数调用的结果将根据目标平台而有所不同。列表的第一个元素表示给定平台的默认快捷键。如果结果包含多个结果，则可以认为是同一平台上的给定 key 的替代快捷键。

静态 listFromString(str[, format=QKeySequence.SequenceFormat.PortableText])#
参数：
返回类型：:

. QKeySequence 列表

根据格式 format，从字符串 str 中返回 QKeySequence 的列表。

静态 listToString(list[, format=QKeySequence.SequenceFormat.PortableText])#
参数：
返回类型：:

str

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

matches(seq)#
参数：

seq – QKeySequence

返回类型：:

SequenceMatch

将序列与 seq 进行对比。如果成功，则返回 ExactMatch；如果 seq 不完全匹配，则返回 PartialMatch；如果序列没有共同之处，则返回 NoMatch。如果 seq 更短，则也返回 NoMatch。

静态 mnemonic(text)#
参数：

text – str

返回类型：:

QKeySequence

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

例如，mnemonic(“E& &Exit”) 返回 Qt::ALT+Qt::Key_X，mnemonic(”& Ess”&Quit”) 返回 ALT+Key_Q，而 mnemonic(“Quit”) 返回一个空的 QKeySequence。

__ne__(other)#
参数：

other – QKeySequence

返回类型：:

bool

返回值：如果此键序列不等于其他键序列，返回 true；否则返回 false。

__lt__(ks)#
参数：

ks – QKeySequence

返回类型：:

bool

提供对键序列与其他键序列的任意比较。可以保证的是，如果两个键序列相等，则运算符返回 false；如果键序列不相等，则 (ks1 < ks2) 等于 !(ks2 < ks1)。

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

参见

operator==() operator!=() operator> operator>=()

__le__(other)#
参数：

other – QKeySequence

返回类型：:

bool

返回值：如果此键序列小于或等于其他键序列，返回 true；否则返回 false。

参见

operator==() operator!=() operator> operator>=()

__eq__(other)#
参数：

other – QKeySequence

返回类型：:

bool

返回值：如果此键序列等于其他键序列，返回 true；否则返回 false。

__gt__(other)#
参数：

other – QKeySequence

返回类型：:

bool

返回值：如果此键序列大于其他键序列，返回 true；否则返回 false。

参见

operator==() operator!=() operator operator>=()

__ge__(other)#
参数：

other – QKeySequence

返回类型：:

bool

如果此键序列大于或等于另一个键序列，则返回 true；否则返回 false。

参见

operator==() operator!=() operator operator>() operator

swap(other)#
参数：

other – QKeySequence

将 other 键序列与此键序列交换。此操作非常快，永远不会失败。

toString([format=QKeySequence.SequenceFormat.PortableText])#
参数：

format – SequenceFormat

返回类型：:

str

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

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

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

在 Apple 平台上，如果 format 是 NativeText，则返回的字符串类似于菜单栏中显示的序列；否则，字符串使用“便携”格式，适合写入文件。

参见

fromString()