Sprache

CompositionAnimation.SetReferenceParameter(String, CompositionObject) Methode

Definition

Namespace:
Microsoft.UI.Composition
Bearbeiten

Legt einen Verweis auf ein Composition -Objekt für die Verwendung mit einer ExpressionAnimation oder einem Ausdruck keyframe fest.

public:
 virtual void SetReferenceParameter(Platform::String ^ key, CompositionObject ^ compositionObject) = SetReferenceParameter;
void SetReferenceParameter(winrt::hstring const& key, CompositionObject const& compositionObject);
public void SetReferenceParameter(string key, CompositionObject compositionObject);
function setReferenceParameter(key, compositionObject)
Public Sub SetReferenceParameter (key As String, compositionObject As CompositionObject)

Parameter

key
String

Platform::String

winrt::hstring

Der Name des festzulegenden Parameters. Der Name kann verwendet werden, um auf den Parameter in der ExpressionAnimation zu verweisen.

compositionObject
CompositionObject

Der CompositionObject-Wert .

Beispiele

Im folgenden Beispiel wird beschrieben, wie Sie eine ExpressionAnimation verwenden, um einen Parallaxeffekt zwischen einem Hintergrund und einem visuellen Vordergrund zu erstellen. Diese Art von Animation kann im Windows 10 Startmenü angezeigt werden.

void CreateParallaxExpression(Visual foreground, Visual background) 
{ 
    var animation = _compositor.CreateExpressionAnimation(); 

    animation.Expression = "foreground.Offset * (foreground.Size / background.Size)"; 

    animation.SetReferenceParameter("foreground", foreground); 
    animation.SetReferenceParameter("background", background); 

    background.StartAnimation("Offset", animation); 
}

Hinweise

Durch Festlegen eines Verweises auf ein CompositionObject kann eine ExpressionAnimation auf eine beliebige animierbare Eigenschaft für dieses CompositionObject verweisen. Der aktuelle Eigenschaftswert von CompositionObject im Kompositor wird beim Berechnen des Werts des Ausdrucks verwendet. Weitere Informationen finden Sie im Abschnitt "Hinweise" von ExpressionAnimation .

Gilt für: