Visual.TransformToVisual(Visual) Visual.TransformToVisual(Visual) Visual.TransformToVisual(Visual) Method

定義

Visual から指定したビジュアル オブジェクトに座標を変換するために使用できる変換を返します。Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

public:
 System::Windows::Media::GeneralTransform ^ TransformToVisual(System::Windows::Media::Visual ^ visual);
public System.Windows.Media.GeneralTransform TransformToVisual (System.Windows.Media.Visual visual);
member this.TransformToVisual : System.Windows.Media.Visual -> System.Windows.Media.GeneralTransform

パラメーター

visual
Visual Visual Visual

座標の変換先となる VisualThe Visual to which the coordinates are transformed.

戻り値

例外

visualnullです。visual is null.

ビジュアル オブジェクトは相対的ではありません。The visual objects are not related.

次のマークアップ例は、TextBlock内に含まれる、StackPanelオブジェクト。The following markup example shows a TextBlock that is contained within a StackPanel object.

<StackPanel Name="myStackPanel" Margin="8">
  <TextBlock Name="myTextBlock" Margin="4" Text="Hello, world" />
</StackPanel>

次のコード例を使用する方法を示しています、TransformToVisualのオフセットを取得するメソッドをStackPanelその子の基準としたTextBlockします。The following code example shows how to use the TransformToVisual method to retrieve the offset of the StackPanel relative to its child TextBlock. オフセット値が含まれている、返された内GeneralTransform値。The offset values are contained within the returned GeneralTransform value.

// Return the general transform for the specified visual object.
GeneralTransform generalTransform1 = myStackPanel.TransformToVisual(myTextBlock);

// Retrieve the point value relative to the child.
Point currentPoint = generalTransform1.Transform(new Point(0, 0));
' Return the general transform for the specified visual object.
Dim generalTransform1 As GeneralTransform = myStackPanel.TransformToVisual(myTextBlock)

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

オフセットがアカウントには、Marginすべてのオブジェクトの値。The offset takes into account the Margin values for all objects. この場合、 X -4、およびY-4 です。In this case, X is -4, and Y is -4. オフセットの値は、親オブジェクトがその子オブジェクトを基準としてオフセット悪影響を及ぼすため、負の値です。The offset values are negative values because the parent object is negatively offset relative to its child object.

注釈

TransformToAncestorTransformToDescendantメソッドを使用して返すビジュアル オブジェクトに変換することもできます。The TransformToAncestor and TransformToDescendant methods can also be used to return a transform for a visual object.

適用対象