# QState Class Reference ## [[QtCore](index.htm) module] 該QState類提供了一個通用的狀態[QStateMachine](qstatemachine.html)。[More...](#details) 繼承[QAbstractState](qabstractstate.html)。 通過繼承[QStateMachine](qstatemachine.html)。 ### Types * `enum ChildMode { ExclusiveStates, ParallelStates }` ### Methods * `__init__ (self, QState?parent?=?None)` * `__init__ (self, ChildMode?childMode, QState?parent?=?None)` * `addTransition (self, QAbstractTransition?transition)` * `QSignalTransition addTransition (self, QObject?sender, SIGNAL()?signal, QAbstractState?target)` * `QSignalTransition addTransition (self, signal?signal, QAbstractState?target)` * `QAbstractTransition addTransition (self, QAbstractState?target)` * `assignProperty (self, QObject?object, str?name, QVariant?value)` * `ChildMode childMode (self)` * `QAbstractState errorState (self)` * `bool event (self, QEvent?e)` * `QAbstractState initialState (self)` * `onEntry (self, QEvent?event)` * `onExit (self, QEvent?event)` * `removeTransition (self, QAbstractTransition?transition)` * `setChildMode (self, ChildMode?mode)` * `setErrorState (self, QAbstractState?state)` * `setInitialState (self, QAbstractState?state)` * `list-of-QAbstractTransition transitions (self)` ### Qt Signals * `void finished ()` * `void propertiesAssigned ()` * * * ## Detailed Description 該QState類提供了一個通用的狀態[QStateMachine](qstatemachine.html)。 QState對象可以有子狀態，可以有過渡到其他國家。 QState是一部分[The State Machine Framework](index.htm)。 該[addTransition](qstate.html#addTransition)（ ）函數添加一個過渡。該[removeTransition](qstate.html#removeTransition)（ ）函數刪除一個過渡。該[transitions](qstate.html#transitions)（ ）函數返回的狀態的向外的轉移。 該[assignProperty](qstate.html#assignProperty)（ ）函數用于定義當進入一種狀態，應該進行財產分配。 頂級狀態，必須通過一個[QStateMachine](qstatemachine.html)對象作為它們的父狀態，或者使用加入到一個狀態機[QStateMachine.addState](qstatemachine.html#addState)（ ） 。 ### States with Child States 該[childMode](qstate.html#childMode-prop)屬性決定了孩子的狀態對待。對于非平行狀態群體，[setInitialState](qstate.html#initialState-prop)（ ）函數必須被調用來設置初始狀態。孩子的狀態是相互排斥的狀態，狀態機需要知道進入哪個孩子的狀態時，父狀態是一個過渡的目標。 國家發出的[QState.finished](qstate.html#finished)（ ）信號，當最后一個孩子的狀態（[QFinalState](qfinalstate.html)）進入。 該[setErrorState](qstate.html#errorState-prop)（）設置狀態的錯誤狀態。錯誤狀態是狀態機將過渡，如果當試圖進入狀態（例如，因為沒有初始狀態已經設置）檢測到一個錯誤的狀態。 * * * ## Type Documentation ``` QState.ChildMode ``` 此枚舉指定如何一個國家的孩子狀態處理。 | Constant | Value | Description | | --- | --- | --- | | `QState.ExclusiveStates` | `0` | 孩子的狀態是互斥的，初始狀態必須通過調用設置[QState.setInitialState](qstate.html#initialState-prop)（ ） 。 | | `QState.ParallelStates` | `1` | 孩子的狀態是平行的。當進入母體的狀態，它的所有子狀態進入并行。 | * * * ## Method Documentation ``` QState.__init__ (self, QState?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個新的狀態，用給定的_parent_狀態。 ``` QState.__init__ (self, ChildMode?childMode, QState?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個新的狀態，用給定的_childMode_和給定的_parent_狀態。 ``` QState.addTransition (self, QAbstractTransition?transition) ``` 該_transition_說法有它的所有權轉移給Qt的。 將給定_transition_。過渡擁有此狀態為源。這個狀態需要過渡的所有權。 ``` QSignalTransition QState.addTransition (self, QObject?sender, SIGNAL()?signal, QAbstractState?target) ``` [](qsignaltransition.html) [增加了與給定關聯的過渡_signal_的給定_sender_對象，并返回新](qsignaltransition.html)[QSignalTransition](qsignaltransition.html)對象。過渡擁有此狀態為源，和給定_target_作為目標的狀態。 ``` QSignalTransition QState.addTransition (self, signal?signal, QAbstractState?target) ``` [ 增加了一個無條件的過渡從這種狀態給定的_target_狀態，然后返回新的轉換對象。 ](qsignaltransition.html) ``` QAbstractTransition QState.addTransition (self, QAbstractState?target) ``` [ 該_target_說法有它的所有權轉移給Qt的。 ``` QState.assignProperty (self, QObject?object, str?name, QVariant?value) ``` 指示這種狀態的屬性與給定的設置_name_的給定_object_為給定的_value_當進入狀態。 ](qabstracttransition.html) [**See also**](qabstracttransition.html) [propertiesAssigned](qstate.html#propertiesAssigned)（ ） 。 ``` ChildMode QState.childMode (self) ``` [](qstate.html#ChildMode-enum) ``` QAbstractState QState.errorState (self) ``` [ ``` bool QState.event (self, QEvent?e) ``` ](qabstractstate.html) [從重新實現](qabstractstate.html)[QObject.event](qobject.html#event)（ ） 。 ``` QAbstractState QState.initialState (self) ``` [ ``` QState.onEntry (self, QEvent?event) ``` ](qabstractstate.html) [從重新實現](qabstractstate.html)[QAbstractState.onEntry](qabstractstate.html#onEntry)（ ） 。 ``` QState.onExit (self, QEvent?event) ``` 從重新實現[QAbstractState.onExit](qabstractstate.html#onExit)（ ） 。 ``` QState.removeTransition (self, QAbstractTransition?transition) ``` 該_transition_爭論 刪除給定的_transition_從這種狀態。過渡狀態釋放所有權。 **See also** [addTransition](qstate.html#addTransition)（ ） 。 ``` QState.setChildMode (self, ChildMode?mode) ``` ``` QState.setErrorState (self, QAbstractState?state) ``` ``` QState.setInitialState (self, QAbstractState?state) ``` ``` list-of-QAbstractTransition QState.transitions (self) ``` 返回此狀態的外向轉移（即過渡的地方這種狀態是[source state](qabstracttransition.html#sourceState-prop)） ，或一個空列表，如果這個國家沒有向外的轉移。 此功能被引入Qt的4.7 。 **See also** [addTransition](qstate.html#addTransition)（ ） 。 * * * ## Qt Signal Documentation ``` void finished () ``` 這是該信號的默認超載。 當進入最后孩子的這個狀態狀態這個信號被發射。 **See also** [QFinalState](qfinalstate.html)。 ``` void propertiesAssigned () ``` 這是該信號的默認超載。 當所有的屬性都被分配了他們的最終值這個信號被發射。如果國家分配一個值，來完成一個動畫存在一個或多個屬性（或者設置在過渡或作為默認的動畫狀態機） ，那么信號將不發射，直到所有這樣的動畫已經播放完畢。 如果沒有相關的動畫，或為國家中沒有定義屬性賦值，那么信號將被立即發射的進入狀態之前。 **See also** [QState.assignProperty](qstate.html#assignProperty)（）和[QAbstractTransition.addAnimation](qabstracttransition.html#addAnimation)（ ） 。