QAbstractAnimation Class Reference · PyQt4 中文文檔

# QAbstractAnimation Class Reference ## [[QtCore](index.htm) module] 該QAbstractAnimation類是所有動畫的基礎。[More...](#details) 繼承[QObject](qobject.html)。通過繼承[QAnimationGroup](qanimationgroup.html)，[QPauseAnimation](qpauseanimation.html)和[QVariantAnimation](qvariantanimation.html)。 ### Types * `enum DeletionPolicy { KeepWhenStopped, DeleteWhenStopped }` * `enum Direction { Forward, Backward }` * `enum State { Stopped, Paused, Running }` ### Methods * `__init__ (self, QObject?parent?=?None)` * `int currentLoop (self)` * `int currentLoopTime (self)` * `int currentTime (self)` * `Direction direction (self)` * `int duration (self)` * `bool event (self, QEvent?event)` * `QAnimationGroup group (self)` * `int loopCount (self)` * `pause (self)` * `resume (self)` * `setCurrentTime (self, int?msecs)` * `setDirection (self, Direction?direction)` * `setLoopCount (self, int?loopCount)` * `setPaused (self, bool)` * `start (self, DeletionPolicy?policy?=?QAbstractAnimation.KeepWhenStopped)` * `State state (self)` * `stop (self)` * `int totalDuration (self)` * `updateCurrentTime (self, int?currentTime)` * `updateDirection (self, Direction?direction)` * `updateState (self, State?newState, State?oldState)` ### Qt Signals * `void currentLoopChanged (int)` * `void directionChanged (QAbstractAnimation::Direction)` * `void finished ()` * `void stateChanged (QAbstractAnimation::State,QAbstractAnimation::State)` * * * ## Detailed Description 該QAbstractAnimation類是所有動畫的基礎。這個類定義了所有的動畫共享的功能的功能。通過繼承這個類，您可以創建自定義動畫，插入的動畫框架的其馀部分。動畫的進度是由它的當前時間（給定[currentLoopTime](qabstractanimation.html#currentLoopTime)（）），這是從動畫開始以毫秒為單位（0）到它的端部（[duration](qabstractanimation.html#duration-prop)（））。動畫運行時的值會自動更新。它也可以直接與設置[setCurrentTime](qabstractanimation.html#currentTime-prop)（）。在任何時候動畫是在三種狀態之一：[Running](qabstractanimation.html#State-enum)，[Stopped](qabstractanimation.html#State-enum)或[Paused](qabstractanimation.html#State-enum) - 被定義[State](qabstractanimation.html#State-enum)枚舉。目前的狀態可以通過調用改變[start](qabstractanimation.html#start)（）[stop](qabstractanimation.html#stop)（）[pause](qabstractanimation.html#pause)（），或[resume](qabstractanimation.html#resume)（）。動畫將重新設定其[current time](qabstractanimation.html#currentTime-prop)當它被啟動。如果暫停，它會繼續恢復時相同的當前時間。當動畫停止時，它不能被恢復，但將保持其當前時間（直到再次啟動）。 QAbstractAnimation會發出[stateChanged](qabstractanimation.html#stateChanged)（）每當它的狀態的變化。動畫可以循環通過設置任意數量的倍[loopCount](qabstractanimation.html#loopCount-prop)屬性。當動畫的當前時間達到[duration](qabstractanimation.html#duration-prop)（），它會重置當前的時間，并保持運行。為1，循環次數（默認值）表示該動畫將運行一次。需要注意的是-1的持續時間意味著動畫將運行到停止，當前的時間將增加下去。當當前時間等于[duration](qabstractanimation.html#duration-prop)（）和動畫是在其最后循環中，[Stopped](qabstractanimation.html#State-enum)進入狀態，而[finished](qabstractanimation.html#finished)（）信號被發射。 QAbstractAnimation提供由子類用于跟蹤動畫的進度純虛函數：[duration](qabstractanimation.html#duration-prop)（）和[updateCurrentTime](qabstractanimation.html#updateCurrentTime)（）。該[duration](qabstractanimation.html#duration-prop)（）函數可以報告一個持續時間為動畫（如上所述）。動畫框架調用[updateCurrentTime](qabstractanimation.html#updateCurrentTime)（）時，當前時間已更改。通過重新實現此功能，您可以跟蹤動畫進度。請注意，無論呼叫也不調用該函數的數量之間的間隔被定義，雖然，它通常是每秒60更新。通過重新實現[updateState](qabstractanimation.html#updateState)（），你可以跟蹤動畫的狀態發生變化，這是不是由時間驅動的動畫特別有用。 * * * ## Type Documentation ``` QAbstractAnimation.DeletionPolicy ``` | Constant | Value | Description | | --- | --- | --- | | `QAbstractAnimation.KeepWhenStopped` | `0` | 停止時的動畫效果將不會被刪除。 | | `QAbstractAnimation.DeleteWhenStopped` | `1` | 停止時，動畫將被自動刪除。 | ``` QAbstractAnimation.Direction ``` 這個枚舉變量描述了動畫的方向時，[Running](qabstractanimation.html#State-enum)狀態。 | Constant | Value | Description | | --- | --- | --- | | `QAbstractAnimation.Forward` | `0` | 隨時間的增加動畫的當前時間（即從0到接近尾聲/時間移動）。 | | `QAbstractAnimation.Backward` | `1` | 隨著時間（即從底/持續時間和對0移動）動畫的當前時間減少。 | **See also** [direction](qabstractanimation.html#direction-prop)。 ``` QAbstractAnimation.State ``` 這個枚舉變量描述了動畫的狀態。 | Constant | Value | Description | | --- | --- | --- | | `QAbstractAnimation.Stopped` | `0` | 動畫沒有運行。這是初始狀態[QAbstractAnimation](qabstractanimation.html)，和國家[QAbstractAnimation](qabstractanimation.html)重新進入時完成。當前時間保持不變，直至[setCurrentTime](qabstractanimation.html#currentTime-prop)（）被調用，或動畫是通過調用啟動[start](qabstractanimation.html#start)（）。 | | `QAbstractAnimation.Paused` | `1` | 動畫暫停（即暫停）。調用[resume](qabstractanimation.html#resume)（）將恢復動畫活動。 | | `QAbstractAnimation.Running` | `2` | 在動畫運行。而控制是在事件循環，[QAbstractAnimation](qabstractanimation.html)將定期更新其當前的時間，調用[updateCurrentTime](qabstractanimation.html#updateCurrentTime)（）在適當的時候。 | **See also** [state](qabstractanimation.html#state-prop)（）和[stateChanged](qabstractanimation.html#stateChanged)（）。 * * * ## Method Documentation ``` QAbstractAnimation.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構建[QAbstractAnimation](qabstractanimation.html)基類和通行證_parent_至[QObject](qobject.html)的構造。 **See also** [QVariantAnimation](qvariantanimation.html)和[QAnimationGroup](qanimationgroup.html)。 ``` int QAbstractAnimation.currentLoop (self) ``` ``` int QAbstractAnimation.currentLoopTime (self) ``` 返回當前循環內的當前時間。它可以從0到[duration](qabstractanimation.html#duration-prop)（）。 **See also** [duration](qabstractanimation.html#duration-prop)（）和[currentTime](qabstractanimation.html#currentTime-prop)。 ``` int QAbstractAnimation.currentTime (self) ``` ``` Direction QAbstractAnimation.direction (self) ``` [ ``` int QAbstractAnimation.duration (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 ``` bool QAbstractAnimation.event (self, QEvent?event) ``` ](qabstractanimation.html#Direction-enum) [從重新實現](qabstractanimation.html#Direction-enum)[QObject.event](qobject.html#event)（）。 ``` QAnimationGroup QAbstractAnimation.group (self) ``` [](qanimationgroup.html) [如果這個動畫的一部分](qanimationgroup.html)[QAnimationGroup](qanimationgroup.html)，這個函數返回一個指針到組，否則返回0 。 **See also** [QAnimationGroup.addAnimation](qanimationgroup.html#addAnimation)（）。 ``` int QAbstractAnimation.loopCount (self) ``` ``` QAbstractAnimation.pause (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void pause()`。暫停動畫。當動畫暫停時，[state](qabstractanimation.html#state-prop)（）返回暫停。價值[currentTime](qabstractanimation.html#currentTime-prop)將保持不變，直到[resume](qabstractanimation.html#resume)（）或[start](qabstractanimation.html#start)（）被調用。如果你想從當前時間繼續，請致電[resume](qabstractanimation.html#resume)（）。 **See also** [start](qabstractanimation.html#start)（）[state](qabstractanimation.html#state-prop)（）和[resume](qabstractanimation.html#resume)（）。 ``` QAbstractAnimation.resume (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void resume()`。它恢復暫停后動畫。當動畫恢復時，它發出的恢復（）和[stateChanged](qabstractanimation.html#stateChanged)（）信號。該currentTime的不被改變。 **See also** [start](qabstractanimation.html#start)（）[pause](qabstractanimation.html#pause)（）和[state](qabstractanimation.html#state-prop)（）。 ``` QAbstractAnimation.setCurrentTime (self, int?msecs) ``` 這種方法也是一個Qt槽與C + +的簽名`void setCurrentTime(int)`。 ``` QAbstractAnimation.setDirection (self, Direction?direction) ``` ``` QAbstractAnimation.setLoopCount (self, int?loopCount) ``` ``` QAbstractAnimation.setPaused (self, bool) ``` 這種方法也是一個Qt槽與C + +的簽名`void setPaused(bool)`。 If _paused_誠然，動畫暫停。如果_paused_是假的，動畫重新開始。 **See also** [state](qabstractanimation.html#state-prop)（）[pause](qabstractanimation.html#pause)（）和[resume](qabstractanimation.html#resume)（）。 ``` QAbstractAnimation.start (self, DeletionPolicy?policy?=?QAbstractAnimation.KeepWhenStopped) ``` 這種方法也是一個Qt槽與C + +的簽名`void start(QAbstractAnimation::DeletionPolicy = QAbstractAnimation.KeepWhenStopped)`。啟動動畫。該_policy_論證說，不論是否當它完成的動畫應該被刪除。當動畫開始，則[stateChanged](qabstractanimation.html#stateChanged)（）信號被發射，和[state](qabstractanimation.html#state-prop)（）返回運行。當控制到達事件循環，動畫將自行運行，周期性地調用[updateCurrentTime](qabstractanimation.html#updateCurrentTime)（）作為動畫的進展。如果動畫目前已停止或已走到了盡頭，調用start （）將回放動畫，并從頭開始。當動畫到達末尾時，動畫要么停止，或者如果在循環水平大于1，它會倒帶，并從開頭繼續。如果動畫已經在運行，這個函數不執行任何操作。 **See also** [stop](qabstractanimation.html#stop)（）和[state](qabstractanimation.html#state-prop)（）。 ``` State QAbstractAnimation.state (self) ``` [ ``` QAbstractAnimation.stop (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void stop()`。 ](qabstractanimation.html#State-enum) [停止播放動畫。當動畫停止時，它發出的](qabstractanimation.html#State-enum)[stateChanged](qabstractanimation.html#stateChanged)（）信號，并[state](qabstractanimation.html#state-prop)（）返回時停止。當前的時間不會改變。如果在到達終點后停止動畫本身（即，[currentLoopTime](qabstractanimation.html#currentLoopTime)（）==[duration](qabstractanimation.html#duration-prop)（）和[currentLoop](qabstractanimation.html#currentLoop-prop)（） \u003e[loopCount](qabstractanimation.html#loopCount-prop)（） - 1 ），則[finished](qabstractanimation.html#finished)（）信號被發射。 **See also** [start](qabstractanimation.html#start)（）和[state](qabstractanimation.html#state-prop)（）。 ``` int QAbstractAnimation.totalDuration (self) ``` 返回動畫的總有效和持續時間，包括循環計數。 **See also** [duration](qabstractanimation.html#duration-prop)（）和[currentTime](qabstractanimation.html#currentTime-prop)。 ``` QAbstractAnimation.updateCurrentTime (self, int?currentTime) ``` 這種方法是抽象的，應在任何子類中重新實現。這個純虛函數被調用每次動畫的_currentTime_變化。 **See also** [updateState](qabstractanimation.html#updateState)（）。 ``` QAbstractAnimation.updateDirection (self, Direction?direction) ``` 這個虛函數被調用[QAbstractAnimation](qabstractanimation.html)當動畫的方向被改變。該_direction_參數是新的方向。 **See also** [setDirection](qabstractanimation.html#direction-prop)（）和[direction](qabstractanimation.html#direction-prop)（）。 ``` QAbstractAnimation.updateState (self, State?newState, State?oldState) ``` 這個虛函數被調用[QAbstractAnimation](qabstractanimation.html)當動畫的狀態從變_oldState_至_newState_。 **See also** [start](qabstractanimation.html#start)（）[stop](qabstractanimation.html#stop)（）[pause](qabstractanimation.html#pause)（）和[resume](qabstractanimation.html#resume)（）。 * * * ## Qt Signal Documentation ``` void currentLoopChanged (int) ``` 這是該信號的默認超載。 [QAbstractAnimation](qabstractanimation.html)發出該信號時電流回路的改變。_currentLoop_是電流回路。 **See also** [currentLoop](qabstractanimation.html#currentLoop-prop)（）和[loopCount](qabstractanimation.html#loopCount-prop)（）。 ``` void directionChanged (QAbstractAnimation::Direction) ``` 這是該信號的默認超載。 [QAbstractAnimation](qabstractanimation.html)發出該信號時的方向已經改變。_newDirection_是新的方向。 **See also** [direction](qabstractanimation.html#direction-prop)。 ``` void finished () ``` 這是該信號的默認超載。 [QAbstractAnimation](qabstractanimation.html)發出此信號后的動畫已經停止，并已達到結束。之后此信號被發射[stateChanged](qabstractanimation.html#stateChanged)（）。 **See also** [stateChanged](qabstractanimation.html#stateChanged)（）。 ``` void stateChanged (QAbstractAnimation::State,QAbstractAnimation::State) ``` 這是該信號的默認超載。 [QAbstractAnimation](qabstractanimation.html)發出這個信號時動畫的狀態已經從_oldState_至_newState_。之后虛擬這個信號被發射[updateState](qabstractanimation.html#updateState)（）函數被調用。 **See also** [updateState](qabstractanimation.html#updateState)（）。