[QtGui module]

该QKeyEvent类描述了一个关键事件。More…

继承QInputEvent。

Methods

  • __init__ (self, QEvent.Type type, int key, Qt.KeyboardModifiers modifiers, QString text = QString(), bool autorep = False, int count = 1)
  • __init__ (self, QKeyEvent)
  • int count (self)
  • bool isAutoRepeat (self)
  • int key (self)
  • bool matches (self, QKeySequence.StandardKey key)
  • Qt.KeyboardModifiers modifiers (self)
  • int nativeModifiers (self)
  • int nativeScanCode (self)
  • int nativeVirtualKey (self)
  • QString text (self)

Special Methods

  • bool __eq__ (self, QKeySequence.StandardKey key)
  • __len__ (self)
  • bool __ne__ (self, QKeySequence.StandardKey key)

Detailed Description

该QKeyEvent类描述了一个关键事件。

当按键按下或释放键事件发送到窗口小部件与键盘输入焦点。

一个关键的事件包含一个特殊的接受标志，指示接收者是否将处理按键事件。你应该调用ignore（ ）如果键按下或释放事件不是由您的Widget处理。一个关键的事件被传播到父控件链，直到一个小部件接受它accept（ ）或事件过滤器会消耗它。多媒体键的按键事件在默认情况下忽略。你应该调用accept（）如果你的widget处理这些事件。

该QWidget.setEnable （）函数可以被用来使能或禁止鼠标和键盘事件为一个部件。

该事件处理程序QWidget.keyPressEvent（ ）QWidget.keyReleaseEvent（ ）QGraphicsItem.keyPressEvent（）和QGraphicsItem.keyReleaseEvent（ ）接收按键事件。

Method Documentation

  1. QKeyEvent.__init__ (self, QEvent.Type type, int key, Qt.KeyboardModifiers modifiers, QString text = QString(), bool autorep = False, int count = 1)

构造一个关键的事件对象。

该type参数必须是QEvent.KeyPress，QEvent.KeyRelease或QEvent.ShortcutOverride。

诠释key对于代码Qt.Key该事件循环应该倾听。如果key为0时，该事件是不是一个已知的密钥的结果，例如，它可能是一个写作顺序或键盘宏的结果。该modifiers保持键盘功能键，并在给定text是，密钥生成的Unicode文本。如果autorep是真的，isAutoRepeat（ ）将是真实的。count是参与事件的键的数目。

  1. QKeyEvent.__init__ (self, QKeyEvent)
  1. int QKeyEvent.count (self)

返回与此事件相关的键的数目。如果text（ ）不是空的，这简直是字符串的长度。

See also Qt.WA_KeyCompression。

  1. bool QKeyEvent.isAutoRepeat (self)

返回True如果此事件来自一个自动重复键，如果它来自一个初始的按键返回False。

注意，如果事件是一个多键压缩事件的部分原因是自动重复，这个函数可以返回True或False不定。

  1. int QKeyEvent.key (self)

返回按下或释放的键的代码。

See Qt.Key供的键盘代码的列表。这些代码是独立于底层窗口系统。请注意，这个函数不资本和非大写字母区分，使用text（ ）函数（返回按键产生的Unicode文本）用于这一目的。

0或值Qt.Key_unknown表示该事件是不是一个已知的密钥的结果，例如，它可能是一个写作顺序，键盘宏，或者由于关键事件的压缩的结果。

See also Qt.WA_KeyCompression。

  1. bool QKeyEvent.matches (self, QKeySequence.StandardKey key)

如果关键事件的给定标准匹配，则返回Truekey否则返回False 。

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

  1. Qt.KeyboardModifiers QKeyEvent.modifiers (self)

[

返回立即存在的事件发生后，键盘修饰符标志。

Warning:此功能不能总是可信的。用户可以通过同时按下混淆Shift键同时释放其中的一个，例如。

](docs_index.htm)

See also QApplication.keyboardModifiers（ ） 。

  1. int QKeyEvent.nativeModifiers (self)

返回一个关键的事件的本地修饰符。如果关键事件中不包含此数据，则返回0 。

注意：本机调节剂可以是0 ，即使键事件包含的扩展信息。

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

  1. int QKeyEvent.nativeScanCode (self)

返回键事件的本机扫描码。如果关键事件中不包含此数据，则返回0 。

注：本机扫描码可能为0 ，即使关键事件包含的扩展信息。

注意：在Mac OS / X ，这个功能是没有用的，因为没有办法从碳或可可得到扫描码。该函数总是返回1（或0的情况下上面所解释的） 。

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

  1. int QKeyEvent.nativeVirtualKey (self)

返回本机的虚拟键或按键事件的键对称。如果关键事件中不包含此数据，则返回0 。

注意：本机虚拟键可以是0 ，即使键事件包含的扩展信息。

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

  1. QString QKeyEvent.text (self)

返回Unicode文本，这个密钥生成。返回的文本可以在修饰键，如Shift键，控制，Alt和梅塔，被按下或释放的情况下，一个空字符串。在这种情况下key（ ）将包含一个有效的值。

See also Qt.WA_KeyCompression。

  1. bool QKeyEvent.__eq__ (self, QKeySequence.StandardKey key)
  1.  QKeyEvent.__len__ (self)
  1. bool QKeyEvent.__ne__ (self, QKeySequence.StandardKey key)