QAbstractEventDispatcher Class Reference · PyQt4 中文文檔

# QAbstractEventDispatcher Class Reference ## [[QtCore](index.htm) module] 該QAbstractEventDispatcher類提供了一個接口來管理Qt的事件隊列中。[More...](#details) 繼承[QObject](qobject.html)。 ### Methods * `__init__ (self, QObject?parent?=?None)` * `closingDown (self)` * `bool filterEvent (self, sip.voidptr?message)` * `flush (self)` * `bool hasPendingEvents (self)` * `interrupt (self)` * `bool processEvents (self, QEventLoop.ProcessEventsFlags?flags)` * `list-of-tuple-of-int-int registeredTimers (self, QObject?object)` * `registerSocketNotifier (self, QSocketNotifier?notifier)` * `int registerTimer (self, int?interval, QObject?object)` * `registerTimer (self, int?timerId, int?interval, QObject?object)` * `callable setEventFilter (self, callable?filter)` * `startingUp (self)` * `unregisterSocketNotifier (self, QSocketNotifier?notifier)` * `bool unregisterTimer (self, int?timerId)` * `bool unregisterTimers (self, QObject?object)` * `wakeUp (self)` ### Static Methods * `QAbstractEventDispatcher instance (QThread?thread?=?None)` ### Qt Signals * `void aboutToBlock ()` * `void awake ()` * * * ## Detailed Description 該QAbstractEventDispatcher類提供了一個接口來管理Qt的事件隊列中。事件調度器接收來自窗口系統和其他來源的事件。它然后將它們發送到[QCoreApplication](qcoreapplication.html) or [QApplication](qapplication.html)例如用于處理和傳遞。 QAbstractEventDispatcher提供細粒度的控制權事件傳遞。對于事件的處理使用簡單的控制[QCoreApplication.processEvents](qcoreapplication.html#processEvents)（）。對于應用程序的事件循環的精細控制，呼叫[instance](qabstracteventdispatcher.html#instance)（）并調用函數返回的QAbstractEventDispatcher對象。如果你想用你自己的QAbstractEventDispatcher的QAbstractEventDispatcher子類或實例，您必須創建您的實例_before_創建[QApplication](qapplication.html)對象。主事件循環是通過調用啟動[QCoreApplication.exec](qcoreapplication.html#exec)（），并停止通過調用[QCoreApplication.exit](qcoreapplication.html#exit)（）。這樣建立的本地事件循環[QEventLoop](qeventloop.html)。執行長時間操作的程序可以調用[processEvents](qabstracteventdispatcher.html#processEvents)（）用按位或各種組合[QEventLoop.ProcessEventsFlag](qeventloop.html#ProcessEventsFlag-enum)值來控制哪些事件應交付。 QAbstractEventDispatcher還允許一個外部事件循環的Qt的事件循環的集成。例如， Motif的擴展包括QAbstractEventDispatcher的重新實現，合并Qt和Motif的事件一起。 * * * ## Method Documentation ``` QAbstractEventDispatcher.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的事件調度給定的_parent_。 ``` QAbstractEventDispatcher.closingDown (self) ``` ``` bool QAbstractEventDispatcher.filterEvent (self, sip.voidptr?message) ``` 發送_message_通過被設置的事件過濾器[setEventFilter](qabstracteventdispatcher.html#setEventFilter)（）。如果沒有事件過濾器被設置，這個函數返回False ，否則，這個函數返回的事件過濾器函數的結果。的子類[QAbstractEventDispatcher](qabstracteventdispatcher.html) _must_調用此函數為_all_從系統收到的信息，以確保與可在應用中使用的任何擴展兼容性。注意，類型_message_依賴于平臺。看[QAbstractEventDispatcher.EventFilter](qabstracteventdispatcher.html#EventFilter-typedef)了解詳情。 **See also** [setEventFilter](qabstracteventdispatcher.html#setEventFilter)（）。 ``` QAbstractEventDispatcher.flush (self) ``` 這種方法是抽象的，應在任何子類中重新實現。刷新事件隊列。這通常幾乎立即返回。不執行任何操作平臺上比X11等。 ``` bool QAbstractEventDispatcher.hasPendingEvents (self) ``` 這種方法是抽象的，應在任何子類中重新實現。返回True如果有一個事件的等待，否則返回False 。 ``` QAbstractEventDispatcher QAbstractEventDispatcher.instance (QThread?thread?=?None) ``` [ 返回一個指向事件調度對象指定_thread_。如果_thread_為零時，當前線程被使用。如果沒有事件調度器存在指定的線程，這個函數返回0 。 **Note:**如果Qt的內置，無需線程的支持，_thread_參數將被忽略。 ``` QAbstractEventDispatcher.interrupt (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 ](qabstracteventdispatcher.html) [中斷事件的調度，即事件調度將返回從](qabstracteventdispatcher.html)[processEvents](qabstracteventdispatcher.html#processEvents)（）盡快。 ``` bool QAbstractEventDispatcher.processEvents (self, QEventLoop.ProcessEventsFlags?flags) ``` 這種方法是抽象的，應在任何子類中重新實現。進程掛起的匹配事件_flags_直到有沒有更多的事件來處理。返回True如果一個事件被處理，否則返回False 。如果你有一個長期運行的操作，要顯示其進展，而不允許用戶輸入，此功能特別有用，即通過使用[QEventLoop.ExcludeUserInputEvents](qeventloop.html#ProcessEventsFlag-enum)標志。如果[QEventLoop.WaitForMoreEvents](qeventloop.html#ProcessEventsFlag-enum)標志被設置在_flags_，這個函數的行為如下： * If events are available, this function returns after processing them. * If no events are available, this function will wait until more are available and return after processing newly available events. 如果[QEventLoop.WaitForMoreEvents](qeventloop.html#ProcessEventsFlag-enum)標志沒有被設置在_flags_，并沒有事件的情況下，這個函數會立即返回。 **Note:**此函數不連續處理事件，它返回后，所有可用的事件被處理。 **See also** [hasPendingEvents](qabstracteventdispatcher.html#hasPendingEvents)（）。 ``` list-of-tuple-of-int-int QAbstractEventDispatcher.registeredTimers (self, QObject?object) ``` 這種方法是抽象的，應在任何子類中重新實現。返回注冊定時器的清單_object_。計時器ID是每對中的第一個成員;的間隔是第二。 ``` QAbstractEventDispatcher.registerSocketNotifier (self, QSocketNotifier?notifier) ``` 這種方法是抽象的，應在任何子類中重新實現。 Registers _notifier_與事件循環。子類必須實現此方法，以配合一個套接字通知到另一個事件循環。 ``` int QAbstractEventDispatcher.registerTimer (self, int?interval, QObject?object) ``` 注冊一個定時器指定_interval_對于給定的_object_。 ``` QAbstractEventDispatcher.registerTimer (self, int?timerId, int?interval, QObject?object) ``` 這種方法是抽象的，應在任何子類中重新實現。注冊一個定時器指定_timerId_和_interval_對于給定的_object_。 ``` callable QAbstractEventDispatcher.setEventFilter (self, callable?filter) ``` 該_filter_參數也可能沒有。取代了事件過濾功能，這[QAbstractEventDispatcher](qabstracteventdispatcher.html)同_filter_并返回被替換的事件過濾功能。只有當前事件過濾器函數被調用。如果你想使用這兩個過濾功能，節省更換[EventFilter](qabstracteventdispatcher.html#EventFilter-typedef)在一個地方，你可以調用它。這里設置的事件過濾器函數被調用，用于從事件之前的系統事件循環采取的所有消息被分派到各自的目標，包括并不意味著Qt的對象的消息。事件過濾器函數應該返回True，如果要過濾的信息，（即停止）。它應該返回False ，以便處理消息繼續。缺省情況下，事件過濾功能設定（即，這個函數返回一個空[EventFilter](qabstracteventdispatcher.html#EventFilter-typedef)它第一次被調用）。 ``` QAbstractEventDispatcher.startingUp (self) ``` ``` QAbstractEventDispatcher.unregisterSocketNotifier (self, QSocketNotifier?notifier) ``` 這種方法是抽象的，應在任何子類中重新實現。取消注冊_notifier_從事件調度。子類必須重寫此方法，以配合一個套接字通知到另一個事件循環。重新實現必須調用基實現。 ``` bool QAbstractEventDispatcher.unregisterTimer (self, int?timerId) ``` 這種方法是抽象的，應在任何子類中重新實現。注銷定時器與給定_timerId_。成功返回True ，否則返回False 。 **See also** [registerTimer](qabstracteventdispatcher.html#registerTimer)（）和[unregisterTimers](qabstracteventdispatcher.html#unregisterTimers)（）。 ``` bool QAbstractEventDispatcher.unregisterTimers (self, QObject?object) ``` 這種方法是抽象的，應在任何子類中重新實現。取消注冊所有與給定的相關聯的定時器_object_。返回True如果所有的計時器都成功刪除，否則返回False 。 **See also** [unregisterTimer](qabstracteventdispatcher.html#unregisterTimer)（）和[registeredTimers](qabstracteventdispatcher.html#registeredTimers)（）。 ``` QAbstractEventDispatcher.wakeUp (self) ``` 這種方法是抽象的，應在任何子類中重新實現。喚醒事件循環。 **Note:**這個功能是[thread-safe](index.htm#thread-safe)。 **See also** [awake](qabstracteventdispatcher.html#awake)（）。 * * * ## Qt Signal Documentation ``` void aboutToBlock () ``` 這是該信號的默認超載。事件循環調用，可以阻止一個函數之前，這個信號被發射。 **See also** [awake](qabstracteventdispatcher.html#awake)（）。 ``` void awake () ``` 這是該信號的默認超載。從可以阻止一個函數的事件循環返回后這個信號被發射。 **See also** [wakeUp](qabstracteventdispatcher.html#wakeUp)（）和[aboutToBlock](qabstracteventdispatcher.html#aboutToBlock)（）。