ValueAnimator 類別

定義

命名空間:: Android.Animation

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。

[Android.Runtime.Register("android/animation/ValueAnimator", DoNotGenerateAcw=true)]
public class ValueAnimator : Android.Animation.Animator

[<Android.Runtime.Register("android/animation/ValueAnimator", DoNotGenerateAcw=true)>]
type ValueAnimator = class
    inherit Animator

繼承: Object

JavaObject

Object

Animator
ValueAnimator

衍生: Android.Animation.ObjectAnimator

Android.Animation.TimeAnimator

屬性: RegisterAttribute

備註

此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。

所有動畫都使用單一的時序脈衝。它會在自訂處理器中執行，確保屬性變更發生在 UI 執行緒上。

預設情況下，ValueAnimator 使用非線性時間插值，透過 AccelerateDecelerateInterpolator 類別，該類別加速進入動畫並減速退出動畫。這種行為可以透過呼叫 ValueAnimator#setInterpolator(TimeInterpolator)來改變。

動畫師可以由程式碼或資源檔案建立。以下是 ValueAnimator 資源檔案的範例：

{

Java 文件 android.animation.ValueAnimator。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
ValueAnimator()	建立一個新的 ValueAnimator 物件。
ValueAnimator(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

欄位

名稱	Description
DurationInfinite	用來表示無限持續時間的值（例如： (繼承來源 Animator)
Infinite	這個值會與屬性一起使用 `#setRepeatCount(int)` ，用來無限重複動畫。
Restart	已淘汰. 當動畫結束且 `repeatCount` 為無限或為正值時，動畫會從頭開始。

屬性

名稱	Description
AnimatedFraction	回傳目前動畫比例，也就是最近一次動畫幀更新時使用的經過/插值比例。
AnimatedValue	當只有一個屬性在動畫中時，這是用這個 `ValueAnimator` 方法計算出的最新值。
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
CurrentPlayTime	取得動畫目前時間的位置，等於當前時間減去動畫開始的時間。 -或- 將動畫位置設定為指定的時間點。
Duration	這會讓動畫長度一致。
DurationScale	回傳 Animator 動畫的系統範圍縮放因子。
FrameDelay	動畫每幀之間的時間（以毫秒計）。 -或- 動畫每幀之間的時間，以毫秒計。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
Interpolator	回傳此動畫所使用的時序插值器。 (繼承來源 Animator)
IsPaused	回傳該動畫師是否目前處於暫停狀態。 (繼承來源 Animator)
IsRunning	回傳該動畫器是否正在運行（已啟動且已超過任何初始啟動延遲期且尚未結束）。
IsStarted	回傳該動畫師是否已啟動且尚未結束。 (繼承來源 Animator)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 JavaObject)
JniPeerMembers	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。
Listeners	取得目前正在監聽該`android.animation.Animator.AnimatorListener`物件事件的集合`Animator`。 (繼承來源 Animator)
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
RepeatCount	定義了動畫應該重複多少次。 -或- 設定動畫應該重複多少次。
RepeatMode	定義了這個動畫在結束時應該做什麼。 -或- 定義這個動畫在結束時應該做什麼。
StartDelay	延遲開始動畫 `#start()` 的時間（以毫秒計）會被呼叫。 -或- 延遲開始動畫 `#start()` 的時間（以毫秒計）被呼叫。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
TotalDuration	取得動畫的總長度，包含動畫序列、開始延遲和重複。 (繼承來源 Animator)

方法

名稱	Description
AddListener(Animator+IAnimatorListener)	將一個聆聽器加入接收器集合，負責在動畫生命週期中傳送事件，例如開始、重複和結束。 (繼承來源 Animator)
AddPauseListener(Animator+IAnimatorPauseListener)	為這個動畫師加入了暫停聆聽器。 (繼承來源 Animator)
AddUpdateListener(ValueAnimator+IAnimatorUpdateListener)	在動畫生命週期中，將一個聆聽器加入接收器，負責更新事件。
AreAnimatorsEnabled()	回傳動畫師是否目前啟用，系統範圍皆如此。
Cancel()	取消動畫。 (繼承來源 Animator)
Clone()	建立並回傳一份此副本 `Object`。 (繼承來源 Animator)
Construct(JniObjectReference, JniObjectReferenceOptions)	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 JavaObject)
End()	動畫結束。 (繼承來源 Animator)
Equals(Object)	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetAnimatedValue(String)	此值為 `ValueAnimatorpropertyName`。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetValues()	回傳這個 ValueAnimator 動畫的值。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OfArgb(Int32[])	構造並回傳一個 ValueAnimator，會在色彩值之間進行動畫。
OfFloat(Single[])	構造並回傳一個 ValueAnimator，會在浮點數值之間進行動畫。
OfInt(Int32[])	構造並回傳一個 ValueAnimator，會在整數值之間進行動畫。
OfObject(ITypeEvaluator, Object[])	建構並回傳一個 ValueAnimator，會在物件值之間進行動畫。
OfPropertyValuesHolder(PropertyValuesHolder[])	構造並回傳一個 ValueAnimator，會在 PropertyValuesHolder 物件指定的值之間進行動畫。
Pause()	暫停一個奔跑動畫。 (繼承來源 Animator)
RegisterDurationScaleChangeListener(ValueAnimator+IDurationScaleChangeListener)	註冊一個 DurationScaleChangeListener。此系統會監聽基於 Animator 的動畫系統範圍縮放因子的變動。
RemoveAllListeners()	移除所有 `#addListener(android.animation.Animator.AnimatorListener) listeners` 和 `#addPauseListener(android.animation.Animator.AnimatorPauseListener) pauseListeners` 從此物件中移除。 (繼承來源 Animator)
RemoveAllUpdateListeners()	移除所有聽眾，讓本動畫的幀更新無法收聽。
RemoveListener(Animator+IAnimatorListener)	會讓聽眾離開現場聽這個動畫。 (繼承來源 Animator)
RemovePauseListener(Animator+IAnimatorPauseListener)	這樣可以移除播放這個動畫的暫停聽眾。 (繼承來源 Animator)
RemoveUpdateListener(ValueAnimator+IAnimatorUpdateListener)	此動畫會移除一個正在聽幀更新的聽者。
Resume()	會恢復暫停動畫，讓動畫師從暫停時繼續。 (繼承來源 Animator)
Reverse()	反向玩 ValueAnimator。
SetCurrentFraction(Single)	將動畫位置設定為指定的比例。
SetDuration(Int64)	設定動畫長度。
SetEvaluator(ITypeEvaluator)	用於計算動畫動畫值時使用的型別評估器。
SetFloatValues(Single[])	設定浮點數值，會在中間動畫。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetInterpolator(ITimeInterpolator)	計算此動畫經過比例時所用的時間插值器。
SetIntValues(Int32[])	設定整數值，會在中間動畫化。
SetObjectValues(Object[])	設定值在這段動畫中進行動畫。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 JavaObject)
SetTarget(Object)	設定目標物件，其屬性會被此動畫動畫所動。 (繼承來源 Animator)
SetupEndValues()	此方法告訴物件使用適當資訊來提取動畫的結尾值。 (繼承來源 Animator)
SetupStartValues()	此方法告訴物件使用適當資訊來提取動畫的起始值。 (繼承來源 Animator)
SetValues(PropertyValuesHolder[])	根據屬性設定在之間動畫的值。
Start()	動畫開始了。 (繼承來源 Animator)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterDurationScaleChangeListener(ValueAnimator+IDurationScaleChangeListener)	取消註冊一個 durrationScaleChangeListener。
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

事件

名稱	Description
AnimationCancel	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 Animator)
AnimationEnd	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 Animator)
AnimationPause	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 Animator)
AnimationRepeat	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 Animator)
AnimationResume	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 Animator)
AnimationStart	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 Animator)
Update	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。 (繼承來源 Animator)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	此類別提供一個簡單的計時引擎，用於執行計算動畫值並將其設定在目標物件上的動畫。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於