Share via


ObjectAnimationUsingKeyFrames.EnableDependentAnimation Eigenschaft

Definition

Ruft einen Wert ab, der deklariert, ob animierte Eigenschaften, die als abhängige Animationen gelten, diese Animationsdeklaration verwenden dürfen, oder legt diesen wert fest.

public:
 property bool EnableDependentAnimation { bool get(); void set(bool value); };
bool EnableDependentAnimation();

void EnableDependentAnimation(bool value);
public bool EnableDependentAnimation { get; set; }
var boolean = objectAnimationUsingKeyFrames.enableDependentAnimation;
objectAnimationUsingKeyFrames.enableDependentAnimation = boolean;
Public Property EnableDependentAnimation As Boolean
<ObjectAnimationUsingKeyFrames EnableDependentAnimation="bool" />

Eigenschaftswert

Boolean

bool

true , wenn die Animation für einen abhängigen Animationsfall verwendet werden kann. false , wenn die Animation nicht für einen abhängigen Animationsfall verwendet werden kann. Der Standardwert ist FALSE.

Hinweise

Was wird als abhängige Animation betrachtet?

Nicht alle von Ihnen erstellten benutzerdefinierten Animationen können standardmäßig in einer Windows-Runtime-App ausgeführt werden, wenn das Animationssystem ermittelt, dass die Animation die Leistung Ihrer Benutzeroberfläche beeinträchtigen kann. Animationen, für die das System eine mögliche Leistungsbeeinträchtigung erkennt, werden als abhängige Animationen bezeichnet. Dies ist abhängig, da Ihre Animation Objekte im UI-Thread aktiv und häufig aktualisiert, wo aktuelle Benutzereingaben und andere programmgesteuerte Updates Laufzeitänderungen an der Benutzeroberfläche vornehmen.

Eine abhängige Animation, die sehr viele Systemressourcen im UI-Thread verbraucht, kann dafür sorgen, dass eine App in bestimmten Situationen scheinbar nicht mehr reagiert. Wenn eine Animation Layoutänderungen bedingt oder die Leistung im UI-Thread potenziell auf andere Weise beeinträchtigen kann, müssen Sie die Animation häufig explizit aktivieren, um die Ausführung zu ermöglichen. Hierzu gibt es die EnableDependentAnimation-Eigenschaft für bestimmte Animationsklassen. Verwenden Sie diese Eigenschaft mit Vorsicht, denn wenn Sie sie auf true festlegen, erkennen Sie bewusst, dass die Animation andere Vorgänge im UI-Thread verlangsamen kann, wenn sie ausgeführt wird.

Weitere Informationen finden Sie unter Storyboardanimationen. Dieses Thema enthält eine Liste der Kriterien für eine unabhängige Animation. Eine Animation ist eine abhängige Animation, wenn sie mindestens eines dieser Kriterien nicht erfüllt. Vergleichen Sie für die bestimmte Eigenschaft, die Sie animieren möchten, und für die Besonderheiten Ihrer Animation die beabsichtigte Animation mit den Kriterien, um festzustellen, ob sie vom System als abhängig oder unabhängig betrachtet wird.

Eine weitere Möglichkeit, um zu ermitteln, ob Ihre Animationen abhängig sind, besteht darin, dass Sie möglicherweise eine Warnung von Der XAML-Entwurfsoberfläche oder dem XAML-Tool erhalten, nachdem Sie diese Animation erstellt haben. Die Warnung gibt an, dass Sie EnableDependentAnimation auf true festlegen müssen, um die Animationsausführung anzuzeigen.

Als App-Entwickler können Sie sich auch für die Anwendung einer App-weiten Einstellung entscheiden, mit der abhängige Animationen stets deaktiviert werden – auch Animationen, für die EnableDependentAnimation auf true festgelegt ist. Siehe Timeline.AllowDependentAnimations. Dies ist nützlich für Sie als App-Entwickler, wenn Sie Steuerelemente verwenden, bei denen die Vorlagen abhängige Animationen enthalten, und Sie dies als Leistungsproblem erkannt haben, aber nicht das gesamte Steuerelement neu entwerfen müssen, um diese Animationen zu deaktivieren.

Gilt für:

Weitere Informationen