# QEventLoop Class Reference ## [[QtCore](index.htm) module] 該QEventLoop類提供進入和離開事件循環的方法。[More...](#details) 繼承[QObject](qobject.html)。 ### Types * `enum ProcessEventsFlag { AllEvents, ExcludeUserInputEvents, ExcludeSocketNotifiers, WaitForMoreEvents, X11ExcludeTimers, DeferredDeletion }` * `class **[ProcessEventsFlags](index.htm)**` ### Methods * `__init__ (self, QObject?parent?=?None)` * `int exec_ (self, ProcessEventsFlags?flags?=?QEventLoop.AllEvents)` * `exit (self, int?returnCode?=?0)` * `bool isRunning (self)` * `bool processEvents (self, ProcessEventsFlags?flags?=?QEventLoop.AllEvents)` * `processEvents (self, ProcessEventsFlags?flags, int?maximumTime)` * `quit (self)` * `wakeUp (self)` * * * ## Detailed Description 該QEventLoop類提供進入和離開事件循環的方法。 在任何時候，你可以創建一個QEventLoop對象，并調用[exec_](qeventloop.html#exec)（ ）就可以啟動一個本地事件循環。從事件循環中，調用[exit](qeventloop.html#exit)（ ）將強制[exec_](qeventloop.html#exec)（ ）返回。 * * * ## Type Documentation ``` QEventLoop.ProcessEventsFlag ``` 該枚舉控制由處理的事件類型[processEvents](qeventloop.html#processEvents)（）函數。 | Constant | Value | Description | | --- | --- | --- | | `QEventLoop.AllEvents` | `0x00` | 所有事件。需要注意的是[DeferredDelete](qevent.html#Type-enum)事件經過特殊加工。看[QObject.deleteLater](qobject.html#deleteLater)（ ）的更多細節。 | | `QEventLoop.ExcludeUserInputEvents` | `0x01` | 不處理用戶輸入事件，如ButtonPress和按鍵。請注意，該事件不會被丟棄，它們會在下一次交付[processEvents](qeventloop.html#processEvents)（）被調用，而不ExcludeUserInputEvents標志。 | | `QEventLoop.ExcludeSocketNotifiers` | `0x02` | 不處理套接字通知事件。請注意，該事件不會被丟棄，它們會在下一次交付[processEvents](qeventloop.html#processEvents)（）被調用，而不ExcludeSocketNotifiers標志。 | | `QEventLoop.WaitForMoreEvents` | `0x04` | 等待事件，如果沒有未處理的事件都可用。 | | `QEventLoop.DeferredDeletion` | `0x10` | 過時 - 不要使用。 | 該ProcessEventsFlags類型是一個typedef為[QFlags](index.htm)\u003cProcessEventsFlag\u003e 。它存儲ProcessEventsFlag值的或組合。 **See also** [processEvents](qeventloop.html#processEvents)（ ） 。 * * * ## Method Documentation ``` QEventLoop.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個事件循環對象與給定_parent_。 ``` int QEventLoop.exec_ (self, ProcessEventsFlags?flags?=?QEventLoop.AllEvents) ``` 進入主事件循環并等待，直到[exit](qeventloop.html#exit)（）被調用。返回傳遞給該值[exit](qeventloop.html#exit)（ ） 。 If _flags_被指定，由所允許的類型的唯一事件_flags_將被處理。 有必要調用這個函數來啟動事件處理。主事件循環接收事件從窗口系統并調度這些應用程序的部件。 一般來說，沒有用戶交互可以調用exec （ ）之前發生。作為一種特殊的情況下，模式對話框喜歡[QMessageBox](qmessagebox.html)調用exec （之前可以使用） ，因為模式對話框使用自己的本地事件循環。 為了使您的應用程序執行閒置處理（即執行一個特殊的功能，每當有沒有掛起的事件） ，請使用[QTimer](qtimer.html)與0超時。更復雜的空閒處理方案可以用來實現[processEvents](qeventloop.html#processEvents)（ ） 。 **See also** [QApplication.quit](qcoreapplication.html#quit)（ ）[exit](qeventloop.html#exit)（）和[processEvents](qeventloop.html#processEvents)（ ） 。 ``` QEventLoop.exit (self, int?returnCode?=?0) ``` 講述了事件循環退出，并返回代碼。 在此之后函數被調用時，事件循環從調用返回[exec_](qeventloop.html#exec)（ ） 。該[exec_](qeventloop.html#exec)（ ）函數返回_returnCode_。 按照慣例，_returnCode_0意味著成功，而任何非零值表示錯誤。 請注意，與同名的C庫函數，這個函數_does_返回給調用者 - 它是事件處理，停止。 **See also** [QCoreApplication.quit](qcoreapplication.html#quit)（ ）[quit](qeventloop.html#quit)（）和[exec_](qeventloop.html#exec)（ ） 。 ``` bool QEventLoop.isRunning (self) ``` 如果事件循環運行，則返回True ，否則返回False 。事件循環被認為是從時間上運行時[exec_](qeventloop.html#exec)（ ）被調用，直到[exit](qeventloop.html#exit)（）被調用。 **See also** [exec_](qeventloop.html#exec)（）和[exit](qeventloop.html#exit)（ ） 。 ``` bool QEventLoop.processEvents (self, ProcessEventsFlags?flags?=?QEventLoop.AllEvents) ``` 進程掛起的匹配事件_flags_直到有沒有更多的事件來處理。如果返回已處理掛起的事件則為True，否則返回False 。 如果你有一個長期運行的操作，要顯示其進展，而不允許用戶輸入，此功能特別有用，即通過使用[ExcludeUserInputEvents](qeventloop.html#ProcessEventsFlag-enum)標志。 這個函數是一個簡單的包裝器[QAbstractEventDispatcher.processEvents](qabstracteventdispatcher.html#processEvents)（ ） 。查看該功能的詳細信息的文檔。 ``` QEventLoop.processEvents (self, ProcessEventsFlags?flags, int?maximumTime) ``` 匹配過程中掛起的事件_flags_最多_maxTime_毫秒，或直到沒有更多的事件來處理，以較短者為準。如果你有一個長期運行的操作，要顯示其進展，而不允許用戶輸入，此功能特別有用，即通過使用[ExcludeUserInputEvents](qeventloop.html#ProcessEventsFlag-enum)標志。 **Notes:** * This function does not process events continuously; it returns after all available events are processed. * Specifying the [WaitForMoreEvents](qeventloop.html#ProcessEventsFlag-enum) flag makes no sense and will be ignored. ``` QEventLoop.quit (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void quit()`。 講述了事件循環正常退出。 同出口（0）。 **See also** [QCoreApplication.quit](qcoreapplication.html#quit)（）和[exit](qeventloop.html#exit)（ ） 。 ``` QEventLoop.wakeUp (self) ``` 喚醒事件循環。 **See also** [QAbstractEventDispatcher.wakeUp](qabstracteventdispatcher.html#wakeUp)（ ） 。