QKeySequence Class Reference

[QtGui module]

该QKeySequence类封装所使用的快捷键的按键顺序。More…

Types

• enum SequenceFormat { NativeText, PortableText }
• enum SequenceMatch { NoMatch, PartialMatch, ExactMatch }
• enum StandardKey { UnknownKey, HelpContents, WhatsThis, Open, ..., Quit }

Methods

• __init__ (self)
• __init__ (self, QKeySequence ks)
• __init__ (self, QString key, SequenceFormat format)
• __init__ (self, int k1, int key2 = 0, int key3 = 0, int key4 = 0)
• __init__ (self, QVariant variant)
• int count (self)
• bool isDetached (self)
• bool isEmpty (self)
• SequenceMatch matches (self, QKeySequence seq)
• swap (self, QKeySequence other)
• QString toString (self, SequenceFormat format = QKeySequence.PortableText)

Static Methods

• QKeySequence fromString (QString str, SequenceFormat format = QKeySequence.PortableText)
• list-of-QKeySequence keyBindings (StandardKey key)
• QKeySequence mnemonic (QString text)

Special Methods

• bool __eq__ (self, QKeySequence other)
• bool __ge__ (self, QKeySequence other)
• int __getitem__ (self, int i)
• bool __gt__ (self, QKeySequence other)
• int __int__ (self)
• bool __le__ (self, QKeySequence other)
• __len__ (self)
• bool __lt__ (self, QKeySequence ks)
• bool __ne__ (self, QKeySequence other)

Detailed Description

这个类可以醃制。

StandardKey，QString或Python的int对象可随时使用QKeySequence预计。

该QKeySequence类封装所使用的快捷键的按键顺序。

在其最常见的形式中，一个键序列描述了必须一起使用，以执行某些操作键的组合。密钥序列用于与QAction对象到指定键盘快捷键可以用来触发动作。

键序列可以用作键盘快捷键在三种不同的方式来构造：

• For standard shortcuts, a standard key can be used to request the platform-specific key sequence associated with each shortcut.
• For custom shortcuts, human-readable strings such as “Ctrl+X” can be used, and these can be translated into the appropriate shortcuts for users of different languages. Translations are made in the “QShortcut“ context.
• For hard-coded shortcuts, integer key codes can be specified with a combination of values defined by the Qt.Key and Qt.Modifier enum values. Each key code consists of a single Qt.Key value and zero or more modifiers, such as Qt.SHIFT, Qt.CTRL, Qt.ALT and Qt.META.

例如，Ctrl P可能用作用于打印文档的快捷方式的序列，并且可以在以下任一方式来指定：

 QKeySequence(QKeySequence.Print);
 QKeySequence(tr("Ctrl+P"));
 QKeySequence(tr("Ctrl+p"));
 QKeySequence([Qt](qt.html).CTRL + [Qt](qt.html).Key_P);

需要注意的是，对于字母，在规范字符串的情况下并不重要。在上面的例子中，用户并不需要按住Shift键激活用的“Ctrl + P ”指定一个快捷方式。然而，对于其他的键，使用Shift作为一个未指定的额外修饰键会导致混乱的键盘布局不同，所使用的那些开发者的应用程序的用户。请参阅Keyboard Layout Issues下面的部分获取更多细节。

优选的是，其中可以使用标准的快捷方式。当创建非标准的快捷键按键顺序，你应该使用人类可读的字符串优先于硬编码的整数值。

QKeySequence对象可以强制转换为QString取得该序列的人类可读的翻译版本。类似地，toString（ ）函数生成的菜单人类可读的字符串使用。在Mac OS X ，适当的符号是用来使用的Macintosh键盘上的特殊键来形容键盘快捷键。

指定硬编码键码的另一种方法是使用字符的Unicode代码点，例如， ‘A’给出了相同的键顺序Qt.Key_A。

Note:在Mac OS X中，提及“ Ctrl”键，Qt.CTRL， Qt.Control和Qt.ControlModifier对应于Command键在Macintosh键盘上，而凡提述“元” ，Qt.META， Qt.Meta和Qt.MetaModifier对应于Control键。在Mac OS X开发人员可以使用相同的快捷键说明在所有平台，并如预期般在Mac OS X的应用程序会自动工作

Standard Shortcuts

QKeySequence定义了许多standard keyboard shortcuts减少设置操作在一个典型的应用程序时所需的努力的量。下表显示了通常由四个广泛使用的平台的应用程序中使用这些标准的快捷方式一些常见的键序列。请注意，在Mac OS X中，Ctrl值对应于Command键在Macintosh键盘上，并且Meta值对应于Control键。

需要注意的是，由于用于标准的快捷方式键顺序的平台之间的不同，你还需要在每个平台上测试你的快捷方式，以确保您不会意外分配相同的密钥序列的许多行动。

Keyboard Layout Issues

许多关键序列规格是由基于某些类型的键盘布局，而不是选择代表一个动作的名称的第一个字母键，如开发商选择Ctrl S（ “ Ctrl + S键” ）或Ctrl C（ “ Ctrl + C键” ） 。此外，由于某些符号只能用组合键对某些键盘布局的帮助输入，用于与一种键盘布局使用按键序列可以映射到一个不同的密钥，地图无钥匙可言，或者需要额外的辅助键来用在不同的键盘布局。

例如，快捷方式，Ctrl plus和Ctrl minus，通常被用作用于图形应用缩放操作的快捷键，并且这些可以的“Ctrl + - ”指定的“Ctrl + + ”和分别。然而，这些快捷方式指定和解释的方式取决于键盘布局。挪威键盘的用户会注意到，+和-键不是键盘上相邻，但仍然能够激活两个快捷键，而不需要按下Shift键。然而，用户与英国的键盘需要按住Shift键进入+符号，使得快捷有效地同为“ Ctrl + Shift + = ” 。

虽然有些开发商可能会采取完全指定所有他们用自己的键盘来启动快捷方式的改性剂，这也将导致不同的键盘布局的用户意外行为。

例如，使用英国键盘的显影剂可能会决定指定“ Ctrl + Shift + =”作为密钥序列，以便创建巧合的行为以同样的方式作为快捷方式Ctrl plus。然而，本=键需要使用被访问的Shift挪威键盘上的按键，有效地使所需要的快捷方式Ctrl Shift Shift =（一个不可能的组合键） 。

其结果是，两个人可读的字符串和硬编码的密钥代码既可以是有问题的指定可以在各种不同的键盘布局中使用的键序列时使用。只有使用standard shortcuts保证了用户将能够使用该开发人员的意图的快捷方式。

尽管这样，我们就可以通过确保人类可读的字符串的使用，从而有可能为不同语言的用户作出键序列的翻译解决这个问题。这种方法会成功的用户，其键盘对他们所使用的语言是最典型布局。

GNU Emacs Style Key Sequences

类似于使用键序列GNU Emacs，允许最多四个按键代码，可以通过使用多个参数的构造函数，或者通过逗号分隔的键序列的人类可读的字符串被创建。

例如，密钥序列Ctrl X其次是Ctrl C，可以使用以下任一方式来指定：

 QKeySequence(tr("Ctrl+X, Ctrl+C"));
 QKeySequence([Qt](qt.html).CTRL + [Qt](qt.html).Key_X, [Qt](qt.html).CTRL + [Qt](qt.html).Key_C);

Warning: A QApplication实例必须已建成创建QKeySequence之前，否则，你的应用程序可能会崩溃。

Type Documentation

QKeySequence.SequenceFormat

QKeySequence.SequenceMatch

QKeySequence.StandardKey

这个枚举表示标准的键绑定。它们可以用于分配依赖于平台的键盘快捷键，一QAction。

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

这个枚举被引入或修改的Qt 4.2 。

Method Documentation

QKeySequence.__init__ (self)

构造一个空键序列。

QKeySequence.__init__ (self, QKeySequence ks)

创建从一个键序列key字符串。例如“ CTRL + O ”给出Ctrl + ‘O’ 。字符串“ Ctrl”键， “Shift”键， “ Alt”键和“元”均确认，以及他们的翻译等价于“QShortcut“上下文（使用QObject.tr（））。

最多四个按键代码可以通过用逗号分隔输入，如： “ALT + X ， Ctrl + S键， Q” 。

key应该是在NativeText格式。

此构造方法通常用于tr（ ） ，这样的快捷键可以更换的翻译：

 [QMenu](qmenu.html) *file = new [QMenu](qmenu.html)(this);
 file->addAction(tr("&Open..."), this, SLOT(open()),
                   [QKeySequence]($docs-qkeysequence.html)(tr("Ctrl+O", "File|Open")));

请注意“文件|打开”翻译注释。它是由无必要手段，但它提供了一些背景的人翻译。

QKeySequence.__init__ (self, QString key, SequenceFormat format)

创建从一个键序列key字符串的基础上format。

此功能被引入Qt的4.7 。

QKeySequence.__init__ (self, int k1, int key2 = 0, int key3 = 0, int key4 = 0)

构建了一个密钥序列具有多达4个按键k1，k2，k3和k4。

关键的代码列在Qt.Key并且可以与改性剂相结合（见Qt.Modifier）如Qt.SHIFT，Qt.CTRL，Qt.ALT或Qt.META。

QKeySequence.__init__ (self, QVariant variant)

拷贝构造函数。使得副本keysequence。

int QKeySequence.count (self)

返回键的键序列的数目。最大值是4 。

QKeySequence QKeySequence.fromString (QString str, SequenceFormat format = QKeySequence.PortableText)

返回QKeySequence从字符串str基于format。

这个函数是Qt 4.1中引入。

See also toString（ ） 。

bool QKeySequence.isDetached (self)

bool QKeySequence.isEmpty (self)

返回True如果密钥序列为空，否则返回False 。

list-of-QKeySequence QKeySequence.keyBindings (StandardKey key)

返回键绑定的列表为给定的key。调用此函数的结果会根据目标平台上有所不同。列表中的第一个元素表示为给定平台的主要捷径。如果结果包含一个以上的结果是，这些可以被认为是另一种快捷方式对给定相同的平台上key。

这个函数中引入了Qt 4.2中。

SequenceMatch QKeySequence.matches (self, QKeySequence seq)

匹配序列seq。回报ExactMatch如果成功的话，PartialMatch如果seq不完全匹配，并NoMatch如果序列没有任何共同之处。回报NoMatch如果seq较短。

QKeySequence QKeySequence.mnemonic (QString text)

[

返回助记符中的快捷键序列text，或者一个空键序列，如果没有助记符发现。

]($docs-qkeysequence.html)

例如，助记符（ “E ＆ XIT ” ）返回Qt.ALT+Qt.Key_X，助记符（ “戒菸大” ）的回报ALT+Key_Q和助记符（ “退出” ）返回一个空QKeySequence。

我们提供了一个list of common mnemonics英文的。在撰写本文时，微软及公开组似乎并没有发出其他语言的等价建议。

See also qt_set_sequence_auto_mnemonic（ ） 。

QKeySequence.swap (self, QKeySequence other)

交换密钥序列other与此键序列。这个操作是非常快的，而且永远不会。

此功能被引入Qt的4.8 。

QString QKeySequence.toString (self, SequenceFormat format = QKeySequence.PortableText)

返回键序列的字符串表示形式的基础上，format。

例如，该值Qt.CTRL+Qt.Key_O结果在“ CTRL + O ” 。如果密钥序列具有多个密钥代码，每一个由逗号分隔的字符串中返回，如“ Alt + X组合，按Ctrl + Y，Z ” 。琴弦， “Ctrl”键， “Shift”键，使用等换算QObject.tr在（ ）中的“QShortcut“上下文。

如果密钥序列没有按键，则返回一个空字符串。

在Mac OS X ，返回的字符串类似于显示在菜单栏的顺序。

这个函数是Qt 4.1中引入。

See also fromString（ ） 。

bool QKeySequence.__eq__ (self, QKeySequence other)

bool QKeySequence.__ge__ (self, QKeySequence other)

int QKeySequence.__getitem__ (self, int i)

bool QKeySequence.__gt__ (self, QKeySequence other)

int QKeySequence.__int__ (self)

bool QKeySequence.__le__ (self, QKeySequence other)

 QKeySequence.__len__ (self)

bool QKeySequence.__lt__ (self, QKeySequence ks)

bool QKeySequence.__ne__ (self, QKeySequence other)