AnimatorSet.Builder 類別

定義

[Android.Runtime.Register("android/animation/AnimatorSet$Builder", DoNotGenerateAcw=true)]
public class AnimatorSet.Builder : Java.Lang.Object

[<Android.Runtime.Register("android/animation/AnimatorSet$Builder", DoNotGenerateAcw=true)>]
type AnimatorSet.Builder = class
    inherit Object

繼承

Object

JavaObject

Object

AnimatorSet.Builder

屬性

RegisterAttribute

備註

這個 Builder 物件是一個工具類別，用來促進在 中 AnimatorSet 加入動畫以及各種動畫之間的關聯。 這些 Builder 方法 AnimatorSet#play(Animator) play() 的目的，以及 的方法 AnimatorSet ，都是為了讓動畫之間的相依關係能夠自然地表達。 開發者也可以使用AnimatorSet#playTogether(Animator[]) playTogether()AnimatorSet#playSequentially(Animator[]) playSequentially()與方法（and methods），但在某些情況下，將動畫成對表達會更簡單。

物件 Builder 無法直接構造，而是透過呼叫 在 AnimatorSet#play(Animator)內部構造。

例如，這會設定一個 AnimatorSet 同時播放 anim1 和 anim2，anim3 在 anim2 結束時播放，anim4 在 anim3 結束時播放：

AnimatorSet s = new AnimatorSet();
                s.play(anim1).with(anim2);
                s.play(anim2).before(anim3);
                s.play(anim4).after(anim3);

請注意 Builder#before(Animator) 範例中同時使用 和 Builder#after(Animator) 。 這些只是表達同一關係的不同方式，目的是根據情況，讓表達方式更自然。

可以對同一 Builder 物件進行多次呼叫，以表達多種關係。 然而，請注意，只有傳遞到初始 AnimatorSet#play(Animator) 方法的動畫才是物件後續呼叫 Builder 中所依賴的。 例如，以下程式碼在 anim1 結束時同時啟動 anim2 和 anim3;Anim2 與 Anim3 之間沒有直接的依賴關係：

AnimatorSet s = new AnimatorSet();
              s.play(anim1).before(anim2).before(anim3);

如果期望結果是先播放 anim1，再播放 anim2，再播放 anim3，這段程式碼就能正確表達這個關係 ：</p>

AnimatorSet s = new AnimatorSet();
              s.play(anim1).before(anim2);
              s.play(anim2).before(anim3);

請注意，有時會表達無法解決且不會產生合理結果的關係。 例如， play(anim1).after(anim1) 完全說不通。 一般來說，應避免這種循環依賴（或較間接的依賴關係，例如 a 依賴 b，而 b 依賴 c，而 c，c又依賴 a）。 只建立一個可以簡化為簡單、單向的動畫關係的 AnimatorSet，這些動畫從不同動畫開始、之前、之後開始。

Java 文件 android.animation.AnimatorSet.Builder。

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