# QKeyEvent Class Reference ## [[QtGui](index.htm) module] 該QKeyEvent類描述了一個關鍵事件。[More...](#details) 繼承[QInputEvent](qinputevent.html)。 ### 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](qevent.html#ignore)（ ）如果鍵按下或釋放事件不是由您的Widget處理。一個關鍵的事件被傳播到父控件鏈，直到一個小部件接受它[accept](qevent.html#accept)（ ）或事件過濾器會消耗它。多媒體鍵的按鍵事件在默認情況下忽略。你應該調用[accept](qevent.html#accept)（）如果你的widget處理這些事件。 該QWidget.setEnable （）函數可以被用來使能或禁止鼠標和鍵盤事件為一個部件。 該事件處理程序[QWidget.keyPressEvent](qwidget.html#keyPressEvent)（ ）[QWidget.keyReleaseEvent](qwidget.html#keyReleaseEvent)（ ）[QGraphicsItem.keyPressEvent](qgraphicsitem.html#keyPressEvent)（）和[QGraphicsItem.keyReleaseEvent](qgraphicsitem.html#keyReleaseEvent)（ ）接收按鍵事件。 * * * ## Method Documentation ``` QKeyEvent.__init__ (self, QEvent.Type?type, int?key, Qt.KeyboardModifiers?modifiers, QString?text?=?QString(), bool?autorep?=?False, int?count?=?1) ``` 構造一個關鍵的事件對象。 該_type_參數必須是[QEvent.KeyPress](qevent.html#Type-enum)，[QEvent.KeyRelease](qevent.html#Type-enum)或[QEvent.ShortcutOverride](qevent.html#Type-enum)。 詮釋_key_對于代碼[Qt.Key](qt.html#Key-enum)該事件循環應該傾聽。如果_key_為0時，該事件是不是一個已知的密鑰的結果，例如，它可能是一個寫作順序或鍵盤宏的結果。該_modifiers_保持鍵盤功能鍵，并在給定_text_是，密鑰生成的Unicode文本。如果_autorep_是真的，[isAutoRepeat](qkeyevent.html#isAutoRepeat)（ ）將是真實的。_count_是參與事件的鍵的數目。 ``` QKeyEvent.__init__ (self, QKeyEvent) ``` ``` int QKeyEvent.count (self) ``` 返回與此事件相關的鍵的數目。如果[text](qkeyevent.html#text)（ ）不是空的，這簡直是字符串的長度。 **See also** [Qt.WA_KeyCompression](qt.html#WidgetAttribute-enum)。 ``` bool QKeyEvent.isAutoRepeat (self) ``` 返回True如果此事件來自一個自動重復鍵，如果它來自一個初始的按鍵返回False。 注意，如果事件是一個多鍵壓縮事件的部分原因是自動重復，這個函數可以返回True或False不定。 ``` int QKeyEvent.key (self) ``` 返回按下或釋放的鍵的代碼。 See [Qt.Key](qt.html#Key-enum)供的鍵盤代碼的列表。這些代碼是獨立于底層窗口系統。請注意，這個函數不資本和非大寫字母區分，使用[text](qkeyevent.html#text)（ ）函數（返回按鍵產生的Unicode文本）用于這一目的。 0或值[Qt.Key_unknown](qt.html#Key-enum)表示該事件是不是一個已知的密鑰的結果，例如，它可能是一個寫作順序，鍵盤宏，或者由于關鍵事件的壓縮的結果。 **See also** [Qt.WA_KeyCompression](qt.html#WidgetAttribute-enum)。 ``` bool QKeyEvent.matches (self, QKeySequence.StandardKey?key) ``` 如果關鍵事件的給定標準匹配，則返回True_key_否則返回False 。 這個函數中引入了Qt 4.2中。 ``` Qt.KeyboardModifiers QKeyEvent.modifiers (self) ``` [ 返回立即存在的事件發生后，鍵盤修飾符標志。 **Warning:**此功能不能總是可信的。用戶可以通過同時按下混淆**Shift**鍵同時釋放其中的一個，例如。 ](index.htm) [**See also**](index.htm) [QApplication.keyboardModifiers](qapplication.html#keyboardModifiers)（ ） 。 ``` int QKeyEvent.nativeModifiers (self) ``` 返回一個關鍵的事件的本地修飾符。如果關鍵事件中不包含此數據，則返回0 。 注意：本機調節劑可以是0 ，即使鍵事件包含的擴展信息。 這個函數中引入了Qt 4.2中。 ``` int QKeyEvent.nativeScanCode (self) ``` 返回鍵事件的本機掃描碼。如果關鍵事件中不包含此數據，則返回0 。 注：本機掃描碼可能為0 ，即使關鍵事件包含的擴展信息。 注意：在Mac OS / X ，這個功能是沒有用的，因為沒有辦法從碳或可可得到掃描碼。該函數總是返回1（或0的情況下上面所解釋的） 。 這個函數中引入了Qt 4.2中。 ``` int QKeyEvent.nativeVirtualKey (self) ``` 返回本機的虛擬鍵或按鍵事件的鍵對稱。如果關鍵事件中不包含此數據，則返回0 。 注意：本機虛擬鍵可以是0 ，即使鍵事件包含的擴展信息。 這個函數中引入了Qt 4.2中。 ``` QString QKeyEvent.text (self) ``` 返回Unicode文本，這個密鑰生成。返回的文本可以在修飾鍵，如Shift鍵，控制，Alt和梅塔，被按下或釋放的情況下，一個空字符串。在這種情況下[key](qkeyevent.html#key)（ ）將包含一個有效的值。 **See also** [Qt.WA_KeyCompression](qt.html#WidgetAttribute-enum)。 ``` bool QKeyEvent.__eq__ (self, QKeySequence.StandardKey?key) ``` ``` QKeyEvent.__len__ (self) ``` ``` bool QKeyEvent.__ne__ (self, QKeySequence.StandardKey?key) ```