VisualTreeHelper.GetTransform(Visual) VisualTreeHelper.GetTransform(Visual) VisualTreeHelper.GetTransform(Visual) VisualTreeHelper.GetTransform(Visual) Method

Definition

Gibt einen Transform-Wert für das Visual zurück.Returns a Transform value for the Visual.

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 Visual Visual Visual

Das Visual, dessen Transformationswert zurückgegeben wird.The Visual whose transform value is returned.

Gibt zurück

Der Transformationswert des Visual oder null, wenn für reference keine Transformation definiert ist.The transform value of the Visual, or null if reference does not have a transform defined.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die GetTransform -Methode verwendet wird, um die Transformation für das angegebene visuelle Objekt abzurufen.The following code example shows how to use the GetTransform method to retrieve the transform for the specified visual object.

// 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

Der Code sollte null vor der Verwendung des zurückgegebenen Werts testen.Your code should test for null before using the returned value. Um den Offset der zurückgegebenen Transformation zurückzugeben, verwenden Transform Sie die-Methode.To return the offset of the returned transform, use the Transform method. Der Offset Wert ist relativ zum übergeordneten Element von Visual.The offset value is relative to the parent of the Visual.

Hinweise

Alternativ können Sie die TransformToAncestor -Methode verwenden, um einen Transformations Wert für den Vorgänger Visualeines zurückzugeben.Alternatively, you can use the TransformToAncestor method to return a transform value for the ancestor of a Visual. Diese Methode gibt immer eine gültige Transformation zurück.This method always returns a valid transform. Im folgenden Codebeispiel wird die Verwendung TransformToAncestor der-Methode veranschaulicht.The following code example shows how to use TransformToAncestor method.

// 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: