QEvent Class Reference · PyQt4 中文文檔

# QEvent Class Reference ## [[QtCore](index.htm) module] 該QEvent的類是所有事件類的基類。事件對象包含事件參數。[More...](#details) 通過繼承[QActionEvent](qactionevent.html)，[QChildEvent](qchildevent.html)，[QCloseEvent](qcloseevent.html)，[QDragLeaveEvent](qdragleaveevent.html)，[QDropEvent](qdropevent.html)，[QDynamicPropertyChangeEvent](qdynamicpropertychangeevent.html)，[QFileOpenEvent](qfileopenevent.html)，[QFocusEvent](qfocusevent.html)，[QGestureEvent](qgestureevent.html)，[QGraphicsSceneEvent](qgraphicssceneevent.html)，[QHelpEvent](qhelpevent.html)，[QHideEvent](qhideevent.html)，[QHoverEvent](qhoverevent.html)，[QIconDragEvent](qicondragevent.html)，[QInputEvent](qinputevent.html)，[QInputMethodEvent](qinputmethodevent.html)，[QMoveEvent](qmoveevent.html)，[QPaintEvent](qpaintevent.html)，[QResizeEvent](qresizeevent.html)，[QShortcutEvent](qshortcutevent.html)，[QShowEvent](qshowevent.html)，[SignalEvent](index.htm)，[WrappedEvent](index.htm)，[QStatusTipEvent](qstatustipevent.html)，[QTimerEvent](qtimerevent.html)，[QWhatsThisClickedEvent](qwhatsthisclickedevent.html)和[QWindowStateChangeEvent](qwindowstatechangeevent.html)。 ### Types * `enum Type { None, Timer, MouseButtonPress, MouseButtonRelease, ..., MaxUser }` ### Methods * `__init__ (self, Type?type)` * `__init__ (self, QEvent)` * `accept (self)` * `ignore (self)` * `bool isAccepted (self)` * `setAccepted (self, bool?accepted)` * `bool spontaneous (self)` * `Type type (self)` ### Static Methods * `int registerEventType (int?hint?=?-1)` * * * ## Detailed Description 該QEvent的類是所有事件類的基類。事件對象包含事件參數。 Qt的主事件循環（[QCoreApplication.exec](qcoreapplication.html#exec)（））獲取從事件隊列本地窗口系統事件，將它們轉換成QEvents ，并將轉換事件[QObject](qobject.html)秒。一般情況下，事件來自底層窗口系統（[spontaneous](qevent.html#spontaneous)（）返回True ），但它也可以使用手動發送事件[QCoreApplication.sendEvent](qcoreapplication.html#sendEvent)（）和[QCoreApplication.postEvent](qcoreapplication.html#postEvent)（）（[spontaneous](qevent.html#spontaneous)（）返回False ）。 [QObjects](index.htm#qobjects)由有接收事件的[QObject.event](qobject.html#event)（）函數調用。該函數可以在子類中重新實現自定義事件處理，并添加額外的事件類型;[QWidget.event](qwidget.html#event)（）是一個顯著的例子。默認情況下，事件分派到事件處理程序一樣[QObject.timerEvent](qobject.html#timerEvent)（）和[QWidget.mouseMoveEvent](qwidget.html#mouseMoveEvent)（）。[QObject.installEventFilter](qobject.html#installEventFilter)（）允許一個對象截獲發往另一個對象的事件。基本的QEvent只包含一個事件類型參數和一個“接受”的標志。在接受標志設置[accept](qevent.html#accept)（），并與清除[ignore](qevent.html#ignore)（）。這是默認設置，但不靠這個作為子類可以選擇清除它在其構造函數。 QEvent的子類包含描述特定事件的附加參數。 * * * ## Type Documentation ``` QEvent.Type ``` 這個枚舉類型定義Qt中有效的事件類型。的事件類型和專門的類為每種類型如下： | Constant | Value | Description | | --- | --- | --- | | `QEvent.None` | `0` | 而不是一個事件。 | | `QEvent.AccessibilityDescription` | `130` | 用于查詢輔助說明文字（[QAccessibleEvent](index.htm)）。 | | `QEvent.AccessibilityHelp` | `119` | 用于查詢輔助說明文字（[QAccessibleEvent](index.htm)）。 | | `QEvent.AccessibilityPrepare` | `86` | 請求無障礙的信息。 | | `QEvent.ActionAdded` | `114` | 一個新的行動已添加（[QActionEvent](qactionevent.html)）。 | | `QEvent.ActionChanged` | `113` | 一個動作已經改變（[QActionEvent](qactionevent.html)）。 | | `QEvent.ActionRemoved` | `115` | 動作已被刪除（[QActionEvent](qactionevent.html)）。 | | `QEvent.ActivationChange` | `99` | Widget的頂層窗口的激活狀態發生了變化。 | | `QEvent.ApplicationActivate` | `121` | 該應用程序已被提供給用戶。 | | `QEvent.ApplicationActivated` | `ApplicationActivate` | 這個枚舉已棄用。使用ApplicationActivate代替。 | | `QEvent.ApplicationDeactivate` | `122` | 該應用程序已暫停，并且是不可用的用戶。 | | `QEvent.ApplicationFontChange` | `36` | 默認的應用程序的字體已經改變。 | | `QEvent.ApplicationLayoutDirectionChange` | `37` | 默認的應用程序布局的方向發生了變化。 | | `QEvent.ApplicationPaletteChange` | `38` | 默認的應用程序的調色板已經改變。 | | `QEvent.ApplicationWindowIconChange` | `35` | 該應用程序的圖標發生了變化。 | | `QEvent.ChildAdded` | `68` | 一個對象得到一個孩子（[QChildEvent](qchildevent.html)）。 | | `QEvent.ChildInserted` | `70` | 一個對象得到一個孩子（[QChildEvent](qchildevent.html)）。[Qt3Support](index.htm)只是，使用ChildAdded代替。 | | `QEvent.ChildPolished` | `69` | 一個widget孩子被拋光（[QChildEvent](qchildevent.html)）。 | | `QEvent.ChildRemoved` | `71` | 對象失去一個孩子（[QChildEvent](qchildevent.html)）。 | | `QEvent.Clipboard` | `40` | 剪貼板中的內容已經改變（ QClipboardEvent ）。 | | `QEvent.Close` | `19` | 窗口小部件被關閉（[QCloseEvent](qcloseevent.html)）。 | | `QEvent.CloseSoftwareInputPanel` | `200` | 一個widget要關閉該軟件輸入面板（SIP ）。 | | `QEvent.ContentsRectChange` | `178` | widget的內容矩形的邊緣改變。 | | `QEvent.ContextMenu` | `82` | 上下文彈出菜單（[QContextMenuEvent](qcontextmenuevent.html)）。 | | `QEvent.CursorChange` | `183` | widget的指針已經改變。 | | `QEvent.DeferredDelete` | `52` | 后，它已清理的對象將被刪除。 | | `QEvent.DragEnter` | `60` | 光標一個拖放操作過程中進入一個小部件（[QDragEnterEvent](qdragenterevent.html)）。 | | `QEvent.DragLeave` | `62` | 光標一個拖放操作過程中留下一個小部件（[QDragLeaveEvent](qdragleaveevent.html)）。 | | `QEvent.DragMove` | `61` | 拖放操作過程中（[QDragMoveEvent](qdragmoveevent.html)）。 | | `QEvent.Drop` | `63` | 拖放操作完成（[QDropEvent](qdropevent.html)）。 | | `QEvent.EnabledChange` | `98` | Widget的啟用狀態已經改變。 | | `QEvent.Enter` | `10` | 鼠標進入widget的邊界。 | | `QEvent.EnterEditFocus` | `150` | 一個編輯器控件獲得焦點時進行編輯。 | | `QEvent.EnterWhatsThisMode` | `124` | 發送到頂層widget開發應用程序進入“這是什么？ ”模式。 | | `QEvent.FileOpen` | `116` | 打開文件的請求（[QFileOpenEvent](qfileopenevent.html)）。 | | `QEvent.FocusIn` | `8` | 窗口小部件獲得鍵盤焦點（[QFocusEvent](qfocusevent.html)）。 | | `QEvent.FocusOut` | `9` | 窗口小部件失去鍵盤焦點（[QFocusEvent](qfocusevent.html)）。 | | `QEvent.FontChange` | `97` | Widget的字體已經改變。 | | `QEvent.GrabKeyboard` | `188` | 項目收益鍵盤捕獲（[QGraphicsItem](qgraphicsitem.html)只）。 | | `QEvent.GrabMouse` | `186` | 項目獲得鼠標抓（[QGraphicsItem](qgraphicsitem.html)只）。 | | `QEvent.GraphicsSceneContextMenu` | `159` | 在圖形場景上下文彈出菜單（[QGraphicsSceneContextMenuEvent](qgraphicsscenecontextmenuevent.html)）。 | | `QEvent.GraphicsSceneDragEnter` | `164` | 光標一個拖放操作過程中進入一個圖形場景（[QGraphicsSceneDragDropEvent](qgraphicsscenedragdropevent.html)）。 | | `QEvent.GraphicsSceneDragLeave` | `166` | 光標一個拖放操作過程中留下的圖形場景（[QGraphicsSceneDragDropEvent](qgraphicsscenedragdropevent.html)）。 | | `QEvent.GraphicsSceneDragMove` | `165` | 拖放操作是在一個場景中的進展（[QGraphicsSceneDragDropEvent](qgraphicsscenedragdropevent.html)）。 | | `QEvent.GraphicsSceneDrop` | `167` | 拖放操作完成了一個場景（[QGraphicsSceneDragDropEvent](qgraphicsscenedragdropevent.html)）。 | | `QEvent.GraphicsSceneHelp` | `163` | 用戶請求幫助的圖形場景（[QHelpEvent](qhelpevent.html)）。 | | `QEvent.GraphicsSceneHoverEnter` | `160` | 鼠標光標進入懸停項目在圖形場景（[QGraphicsSceneHoverEvent](qgraphicsscenehoverevent.html)）。 | | `QEvent.GraphicsSceneHoverLeave` | `162` | 將鼠標光標離開懸停項目在圖形場景（[QGraphicsSceneHoverEvent](qgraphicsscenehoverevent.html)）。 | | `QEvent.GraphicsSceneHoverMove` | `161` | 將鼠標光標懸停項目內移動在圖形場景（[QGraphicsSceneHoverEvent](qgraphicsscenehoverevent.html)）。 | | `QEvent.GraphicsSceneMouseDoubleClick` | `158` | 鼠標再次按下（雙擊）在圖形場景（[QGraphicsSceneMouseEvent](qgraphicsscenemouseevent.html)）。 | | `QEvent.GraphicsSceneMouseMove` | `155` | 移動鼠標在圖形場景（[QGraphicsSceneMouseEvent](qgraphicsscenemouseevent.html)）。 | | `QEvent.GraphicsSceneMousePress` | `156` | 在圖形場景中按下鼠標（[QGraphicsSceneMouseEvent](qgraphicsscenemouseevent.html)）。 | | `QEvent.GraphicsSceneMouseRelease` | `157` | 釋放鼠標在圖形場景（[QGraphicsSceneMouseEvent](qgraphicsscenemouseevent.html)）。 | | `QEvent.GraphicsSceneMove` | `182` | 窗口小部件被感動（[QGraphicsSceneMoveEvent](qgraphicsscenemoveevent.html)）。 | | `QEvent.GraphicsSceneResize` | `181` | 小部件調整大小（[QGraphicsSceneResizeEvent](qgraphicssceneresizeevent.html)）。 | | `QEvent.GraphicsSceneWheel` | `168` | 在圖形場景中鼠標滾輪滾動（[QGraphicsSceneWheelEvent](qgraphicsscenewheelevent.html)）。 | | `QEvent.Hide` | `18` | 窗口小部件被隱藏（[QHideEvent](qhideevent.html)）。 | | `QEvent.HideToParent` | `27` | 孩子小部件已被隱藏。 | | `QEvent.HoverEnter` | `127` | 鼠標光標進入懸停窗口小部件（[QHoverEvent](qhoverevent.html)）。 | | `QEvent.HoverLeave` | `128` | 將鼠標光標離開懸停窗口小部件（[QHoverEvent](qhoverevent.html)）。 | | `QEvent.HoverMove` | `129` | 將鼠標光標懸停widget內移動（[QHoverEvent](qhoverevent.html)）。 | | `QEvent.IconDrag` | `96` | 窗口的主圖標已經被拖走（[QIconDragEvent](qicondragevent.html)）。 | | `QEvent.IconTextChange` | `101` | Widget的圖標已被修改。 | | `QEvent.InputMethod` | `83` | 一種輸入方法正在使用（[QInputMethodEvent](qinputmethodevent.html)）。 | | `QEvent.KeyPress` | `6` | 按鍵（[QKeyEvent](qkeyevent.html)）。 | | `QEvent.KeyRelease` | `7` | 鍵釋放（[QKeyEvent](qkeyevent.html)）。 | | `QEvent.LanguageChange` | `89` | 該應用程序翻譯修改。 | | `QEvent.LayoutDirectionChange` | `90` | 布局的方向改變。 | | `QEvent.LayoutRequest` | `76` | 小部件的布局需要重做。 | | `QEvent.Leave` | `11` | 鼠標離開控件的邊界。 | | `QEvent.LeaveEditFocus` | `151` | 一個編輯器控件失去焦點時進行編輯。 | | `QEvent.LeaveWhatsThisMode` | `125` | 發送到頂層的小部件應用程序離開時， “這是什么？ ”模式。 | | `QEvent.LocaleChange` | `88` | 系統語言環境發生了變化。 | | `QEvent.NonClientAreaMouseButtonDblClick` | `176` | 鼠標雙擊發生在客戶區之外。 | | `QEvent.NonClientAreaMouseButtonPress` | `174` | 鼠標按下按鈕時發生的工作區之外。 | | `QEvent.NonClientAreaMouseButtonRelease` | `175` | 鼠標按鈕釋放發生在客戶區之外。 | | `QEvent.NonClientAreaMouseMove` | `173` | 鼠標移動時發生的工作區之外。 | | `QEvent.MacSizeChange` | `177` | 用戶改變了他的部件尺寸（僅限Mac OS X ）。 | | `QEvent.MenubarUpdated` | `153` | 該窗口的菜單欄已更新。 | | `QEvent.MetaCall` | `43` | 通過異步方法調用[QMetaObject.invokeMethod](qmetaobject.html#invokeMethod)（）。 | | `QEvent.ModifiedChange` | `102` | 小工具修改狀態已經改變。 | | `QEvent.MouseButtonDblClick` | `4` | 鼠標再次按（[QMouseEvent](qmouseevent.html)）。 | | `QEvent.MouseButtonPress` | `2` | 按下鼠標（[QMouseEvent](qmouseevent.html)）。 | | `QEvent.MouseButtonRelease` | `3` | 鼠標釋放（[QMouseEvent](qmouseevent.html)）。 | | `QEvent.MouseMove` | `5` | 鼠標移動（[QMouseEvent](qmouseevent.html)）。 | | `QEvent.MouseTrackingChange` | `109` | 鼠標跟蹤狀態已經改變。 | | `QEvent.Move` | `13` | widget的位置改變（[QMoveEvent](qmoveevent.html)）。 | | `QEvent.Paint` | `12` | 屏幕更新必要的（[QPaintEvent](qpaintevent.html)）。 | | `QEvent.PaletteChange` | `39` | 窗口小部件的調色板改變。 | | `QEvent.ParentAboutToChange` | `131` | 窗口小部件的父即將改變。 | | `QEvent.ParentChange` | `21` | 窗口小部件的父已經改變。 | | `QEvent.PlatformPanel` | `212` | 特定于平臺的面板已要求。 | | `QEvent.Polish` | `75` | 窗口小部件進行拋光。 | | `QEvent.PolishRequest` | `74` | 窗口小部件應進行打磨。 | | `QEvent.QueryWhatsThis` | `123` | 該部件應該接受的情況下，如果它“這是什么？ ”幫助。 | | `QEvent.RequestSoftwareInputPanel` | `199` | 一個widget要開一個軟件輸入面板（SIP ）。 | | `QEvent.Resize` | `14` | widget的大小改變（[QResizeEvent](qresizeevent.html)）。 | | `QEvent.Shortcut` | `117` | 在孩子的快捷鍵操作按鍵（[QShortcutEvent](qshortcutevent.html)）。 | | `QEvent.ShortcutOverride` | `51` | 在孩子的按鍵，為壓倒一切的快捷鍵操作（[QKeyEvent](qkeyevent.html)）。 | | `QEvent.Show` | `17` | 窗口小部件被顯示在屏幕上（[QShowEvent](qshowevent.html)）。 | | `QEvent.ShowToParent` | `26` | 孩子小部件已被證明。 | | `QEvent.SockAct` | `50` | 插座激活，用于實現[QSocketNotifier](qsocketnotifier.html)。 | | `QEvent.StateMachineSignal` | `192` | 交付給一個狀態機（信號[QStateMachine.SignalEvent](index.htm)）。 | | `QEvent.StateMachineWrapped` | `193` | 本次活動是一個包裝，即包含，另一個事件（[QStateMachine.WrappedEvent](index.htm)）。 | | `QEvent.StatusTip` | `112` | 一個狀態提示要求（[QStatusTipEvent](qstatustipevent.html)）。 | | `QEvent.StyleChange` | `100` | widget的風格已經改變了。 | | `QEvent.TabletMove` | `87` | Wacom數位板移動（[QTabletEvent](qtabletevent.html)）。 | | `QEvent.TabletPress` | `92` | Wacom數位板按（[QTabletEvent](qtabletevent.html)）。 | | `QEvent.TabletRelease` | `93` | Wacom數位板發布（[QTabletEvent](qtabletevent.html)）。 | | `QEvent.OkRequest` | `94` | 在裝修ok鍵按下。僅適用于Windows CE所支持。 | | `QEvent.TabletEnterProximity` | `171` | Wacom數位板進入接近事件（[QTabletEvent](qtabletevent.html)），發送到[QApplication](qapplication.html)。 | | `QEvent.TabletLeaveProximity` | `172` | Wacom數位板假期接近事件（[QTabletEvent](qtabletevent.html)），發送到[QApplication](qapplication.html)。 | | `QEvent.Timer` | `1` | 常規的定時器??事件（[QTimerEvent](qtimerevent.html)）。 | | `QEvent.ToolBarChange` | `120` | 該工具欄按鈕是切換在Mac OS X | | `QEvent.ToolTip` | `110` | 請求了工具提示（[QHelpEvent](qhelpevent.html)）。 | | `QEvent.ToolTipChange` | `184` | widget的工具提示發生了變化。 | | `QEvent.UngrabKeyboard` | `189` | 項目失去鍵盤搶（[QGraphicsItem](qgraphicsitem.html)只）。 | | `QEvent.UngrabMouse` | `187` | 項目失去鼠標抓（[QGraphicsItem](qgraphicsitem.html)只）。 | | `QEvent.UpdateLater` | `78` | 窗口小部件應進行排隊在稍后的時間重新繪制。 | | `QEvent.UpdateRequest` | `77` | 窗口小部件，應重新繪制。 | | `QEvent.WhatsThis` | `111` | 窗口小部件應顯示“這是什么？ ”幫助（[QHelpEvent](qhelpevent.html)）。 | | `QEvent.WhatsThisClicked` | `118` | 在widget的一個鏈接“這是什么？ ”幫助被點擊了。 | | `QEvent.Wheel` | `31` | 鼠標滾輪滾動（[QWheelEvent](qwheelevent.html)）。 | | `QEvent.WinEventAct` | `132` | 發生了針對Windows的激活事件。 | | `QEvent.WindowActivate` | `24` | 窗口被激活。 | | `QEvent.WindowBlocked` | `103` | 該窗口被阻止通過一個模態對話框。 | | `QEvent.WindowDeactivate` | `25` | 窗口被激活。 | | `QEvent.WindowIconChange` | `34` | 窗口的圖標發生了變化。 | | `QEvent.WindowStateChange` | `105` | 該[window's state](qwidget.html#windowState)（最小化，最大化或全屏）已經改變（[QWindowStateChangeEvent](qwindowstatechangeevent.html)）。 | | `QEvent.WindowTitleChange` | `33` | 一直窗口標題改變。 | | `QEvent.WindowUnblocked` | `104` | 該窗口是暢通的一個模態對話框退出后。 | | `QEvent.ZOrderChange` | `126` | widget的Z順序發生了變化。此事件不會發送給頂層窗口。 | | `QEvent.KeyboardLayoutChange` | `169` | 鍵盤布局發生了變化。 | | `QEvent.DynamicPropertyChange` | `170` | 動態屬性添加，更改或從對象中刪除。 | | `QEvent.TouchBegin` | `194` | 開始的觸摸屏和/或跟蹤墊的事件序列（[QTouchEvent](qtouchevent.html)） | | `QEvent.TouchUpdate` | `195` | 觸摸屏事件（[QTouchEvent](qtouchevent.html)） | | `QEvent.TouchEnd` | `196` | 觸摸事件序列結束（[QTouchEvent](qtouchevent.html)） | | `QEvent.WinIdChange` | `203` | 窗口系統標識符為這個原生窗口部件已經改變 | | `QEvent.Gesture` | `198` | 手勢被觸發（[QGestureEvent](qgestureevent.html)） | | `QEvent.GestureOverride` | `202` | 手勢復蓋被觸發（[QGestureEvent](qgestureevent.html)） | 用戶事件應具備的價值觀`User`和`MaxUser`： | Constant | Value | Description | | --- | --- | --- | | `QEvent.User` | `1000` | 用戶定義的事件。 | | `QEvent.MaxUser` | `65535` | 最后用戶事件ID。 | 為方便起見，你可以使用[registerEventType](qevent.html#registerEventType)（）函數來注冊的和預定你的應用程序的自定義事件類型。這樣做可以讓你避免意外重新使用已經在使用自定義事件類型的應用程序中的其他地方。 * * * ## Method Documentation ``` QEvent.__init__ (self, Type?type) ``` Contructs類型的事件對象_type_。 ``` QEvent.__init__ (self, QEvent) ``` ``` QEvent.accept (self) ``` 設置事件對象，調用setAccepted （真）的等價的接受標志。設定接受參數表示該事件接收器想要的事件。不需要的事件可能會被傳播到父widget 。 **See also** [ignore](qevent.html#ignore)（）。 ``` QEvent.ignore (self) ``` 清除事件對象的接受標志參數，調用setAccepted （假）的等價物。清除接受參數表示事件接收器不想要的事件。不需要的事件可能會被傳播到父widget 。 **See also** [accept](qevent.html#accept)（）。 ``` bool QEvent.isAccepted (self) ``` ``` int QEvent.registerEventType (int?hint?=?-1) ``` 寄存器并返回一個自定義的事件類型。該_hint_設置將被使用，如果它是可用的，否則會之間返回值[QEvent.User](qevent.html#Type-enum)和[QEvent.MaxUser](qevent.html#Type-enum)一個尚未被注冊。該_hint_如果其值不間被忽略[QEvent.User](qevent.html#Type-enum)和[QEvent.MaxUser](qevent.html#Type-enum)。 **Note:**這個功能是[thread-safe](index.htm#thread-safe)。此功能被引入Qt的4.4 。 ``` QEvent.setAccepted (self, bool?accepted) ``` ``` bool QEvent.spontaneous (self) ``` 返回True如果該事件起源于應用程序（系統事件）之外，否則返回False 。這個函數的返回值是沒有定義的繪制事件。 ``` Type QEvent.type (self) ``` [ 返回的事件類型。 ](qevent.html#Type-enum)