VisualTreeHelper.GetTransform(Visual) Methode

Definition

Gibt einen Transform-Wert für das Visual zurück.

public:
 static System::Windows::Media::Transform ^ GetTransform(System::Windows::Media::Visual ^ reference);
public static System.Windows.Media.Transform GetTransform (System.Windows.Media.Visual reference);
static member GetTransform : System.Windows.Media.Visual -> System.Windows.Media.Transform
Public Shared Function GetTransform (reference As Visual) As Transform

Parameter

reference
Visual

Das Visual, dessen Transformationswert zurückgegeben wird.

Gibt zurück

Der Transformationswert des Visual oder null, wenn für reference keine Transformation definiert ist.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die GetTransform -Methode verwendet wird, um die Transformation für das angegebene visuelle Objekt abzurufen.

// Return the transform for the specified visual object.
Transform transform = VisualTreeHelper.GetTransform(myDrawing);

// If there is no transform defined for the object, the return value is null.
if (transform != null)
{
    // Return the offset of the returned transform. The offset is relative to the parent of the visual object.
    Point pt = transform.Transform(new Point(0, 0));
}
' Return the transform for the specified visual object.
Dim transform As Transform = VisualTreeHelper.GetTransform(myDrawing)

' If there is no transform defined for the object, the return value is null.
If transform IsNot Nothing Then
    ' Return the offset of the returned transform. The offset is relative to the parent of the visual object.
    Dim pt As Point = transform.Transform(New Point(0, 0))
End If

Ihr Code sollte vor der Verwendung des zurückgegebenen Werts auf null testen. Verwenden Sie Transform die -Methode, um den Offset der zurückgegebenen Transformation zurückzugeben. Der Offsetwert ist relativ zum übergeordneten von Visual.

Hinweise

Alternativ können Sie die TransformToAncestor -Methode verwenden, um einen Transformationswert für den Vorgänger eines Visualzurückzugeben. Diese Methode gibt immer eine gültige Transformation zurück. Im folgenden Codebeispiel wird die Verwendung TransformToAncestor der -Methode veranschaulicht.

// Return the general transform for the specified visual object.
GeneralTransform generalTransform1 = myTextBlock.TransformToAncestor((Visual)myTextBlock.Parent);

// Retrieve the point value relative to the parent.
Point currentPoint = generalTransform1.Transform(new Point(0, 0));
' Return the general transform for the specified visual object.
Dim generalTransform1 As GeneralTransform = myTextBlock.TransformToAncestor(CType(myTextBlock.Parent, Visual))

' Retrieve the point value relative to the parent.
Dim currentPoint As Point = generalTransform1.Transform(New Point(0, 0))

Gilt für: