VisualTreeHelper.GetTransform(Visual) メソッド

定義

TransformVisual 値を返します。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

パラメーター

reference
Visual

変換値が返される VisualThe Visual whose transform value is returned.

戻り値

Visual の変換値。null に変換が定義されていない場合は referenceThe transform value of the Visual, or null if reference does not have a transform defined.

次のコード例は、GetTransform メソッドを使用して、指定されたビジュアルオブジェクトの変換を取得する方法を示しています。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

コードでは、戻り値を使用する前に null をテストする必要があります。Your code should test for null before using the returned value. 返された変換のオフセットを返すには、Transform メソッドを使用します。To return the offset of the returned transform, use the Transform method. オフセット値は、Visualの親を基準とした相対値です。The offset value is relative to the parent of the Visual.

注釈

または、TransformToAncestor メソッドを使用して、Visualの先祖の変換値を返すこともできます。Alternatively, you can use the TransformToAncestor method to return a transform value for the ancestor of a Visual. このメソッドは常に有効な変換を返します。This method always returns a valid transform. TransformToAncestor メソッドを使用する方法を次のコード例に示します。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))

適用対象