# QShortcut Class Reference ## [[QtGui](index.htm) module] 該QShortcut類用于創建鍵盤快捷鍵。[More...](#details) 繼承[QObject](qobject.html)。 ### Methods * `__init__ (self, QWidget?parent)` * `__init__ (self, QKeySequence?key, QWidget?parent, SLOT()?member?=?0, SLOT()?ambiguousMember?=?0, Qt.ShortcutContext?context?=?Qt.WindowShortcut)` * `bool autoRepeat (self)` * `Qt.ShortcutContext context (self)` * `bool event (self, QEvent?e)` * `int id (self)` * `bool isEnabled (self)` * `QKeySequence key (self)` * `QWidget parentWidget (self)` * `setAutoRepeat (self, bool?on)` * `setContext (self, Qt.ShortcutContext?context)` * `setEnabled (self, bool?enable)` * `setKey (self, QKeySequence?key)` * `setWhatsThis (self, QString?text)` * `QString whatsThis (self)` ### Qt Signals * `void activated ()` * `void activatedAmbiguously ()` * * * ## Detailed Description 該QShortcut類用于創建鍵盤快捷鍵。 該QShortcut類提供連接的鍵盤快捷鍵Qt的一種方式[signals and slots](index.htm#signals-and-slots)機制，使執行的快捷方式時，對象可以獲知。快捷方式可以設置為包含必要說明的鍵盤快捷鍵的所有按鍵，包括修改鍵，如的狀態**Shift**，**Ctrl**和**Alt**。 對某些小部件，使用' ＆ '在字符前面將自動為角色創建一個助記符（快捷方式） ，如： “ E＆ XIT ”，將創建快捷方式**Alt+X**（使用“\u0026\u0026”來顯示實際的符號） 。窗口小部件可能會消耗并執行一個給定的快捷操作。在X11 ＆符號將不會顯示和字符將被下劃線。在Windows中，快捷方式通常不會直到用戶按下顯示**Alt**鍵，但是這是一種設置，用戶可以改變。在Mac上，快捷鍵默認情況下禁用。通話[qt_set_sequence_auto_mnemonic](index.htm#qt_set_sequence_auto_mnemonic)（）來啟用它們。但是，由于記憶的快捷方式不Aqua的指導方針適應， Qt會不顯示快捷方式的字符加下劃線。 對于使用的菜單的應用程序，它可以是更方便地使用在所提供的便利的功能[QMenu](qmenu.html)類，因為它們是創建指定鍵盤快捷鍵的菜單項。可替換地，快捷可以與其它類型的動作的相關[QAction](qaction.html)類。 創建用于特定插件的快捷方式的最簡單方法是構造一個密鑰序列的捷徑。例如： ``` shortcut = new QShortcut([QKeySequence](qkeysequence.html)(tr("Ctrl+O", "File|Open")), parent); ``` 當用戶鍵入[key sequence](qkeysequence.html)對于給定的快捷方式，快捷方式的[activated](qshortcut.html#activated)（）信號被發射。 （在歧義的情況下，該[activatedAmbiguously](qshortcut.html#activatedAmbiguously)（ ）信號被發射。 ）的快捷方式“聽了”通過Qt的事件循環時快捷的父控件接收事件。 一個快捷的按鍵順序可以被設置[setKey](qshortcut.html#key-prop)（）和檢索與[key](qshortcut.html#key-prop)（ ） 。快捷方式可以啟用或禁用[setEnabled](qshortcut.html#enabled-prop)（ ） ，并且可以有“這是什么？ ”幫助文本與集[setWhatsThis](qshortcut.html#whatsThis-prop)（ ） 。 * * * ## Method Documentation ``` QShortcut.__init__ (self, QWidget?parent) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個[QShortcut](qshortcut.html)為對象_parent_小工具。由于沒有指定快捷鍵序列，該快捷方式將不會發出任何信號。 **See also** [setKey](qshortcut.html#key-prop)（ ） 。 ``` QShortcut.__init__ (self, QKeySequence?key, QWidget?parent, SLOT()?member?=?0, SLOT()?ambiguousMember?=?0, Qt.ShortcutContext?context?=?Qt.WindowShortcut) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個[QShortcut](qshortcut.html)為對象_parent_小工具。快捷操作其父，監聽[QShortcutEvent](qshortcutevent.html)器匹配的_key_序列。根據事件的模糊性，快捷方式將調用_member_功能，或_ambiguousMember_功能，如果按鍵在快捷方式的_context_。 ``` bool QShortcut.autoRepeat (self) ``` ``` Qt.ShortcutContext QShortcut.context (self) ``` [ ``` bool QShortcut.event (self, QEvent?e) ``` ``` int QShortcut.id (self) ``` 返回快捷方式的ID 。 ](qt.html#ShortcutContext-enum) [**See also**](qt.html#ShortcutContext-enum) [QShortcutEvent.shortcutId](qshortcutevent.html#shortcutId)（ ） 。 ``` bool QShortcut.isEnabled (self) ``` ``` QKeySequence QShortcut.key (self) ``` [](qkeysequence.html) ``` QWidget QShortcut.parentWidget (self) ``` [ 返回快捷方式的父控件。 ``` QShortcut.setAutoRepeat (self, bool?on) ``` ``` QShortcut.setContext (self, Qt.ShortcutContext?context) ``` ``` QShortcut.setEnabled (self, bool?enable) ``` ``` QShortcut.setKey (self, QKeySequence?key) ``` ``` QShortcut.setWhatsThis (self, QString?text) ``` ``` QString QShortcut.whatsThis (self) ``` * * * ## Qt Signal Documentation ``` void activated () ``` 這是該信號的默認超載。 這個信號被發射當用戶鍵入快捷方式的按鍵順序。 ](qwidget.html) [**See also**](qwidget.html) [activatedAmbiguously](qshortcut.html#activatedAmbiguously)（ ） 。 ``` void activatedAmbiguously () ``` 這是該信號的默認超載。 當一個鍵序列被鍵盤輸入的字符，它是說，只要它的多個快捷方式啟動匹配不明確。 當一個快捷方式的鍵序列完成后， activatedAmbiguously （ ）是在密鑰序列仍然是模糊的（也就是說，它是一個或多個其它的快捷方式啟動）發出。該[activated](qshortcut.html#activated)（）信號不被在此情況下發射的光。 **See also** [activated](qshortcut.html#activated)（ ） 。