Visual.TransformToDescendant(Visual) Visual.TransformToDescendant(Visual) Visual.TransformToDescendant(Visual) Visual.TransformToDescendant(Visual) Method

定義

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

public:
 System::Windows::Media::GeneralTransform ^ TransformToDescendant(System::Windows::Media::Visual ^ descendant);
public System.Windows.Media.GeneralTransform TransformToDescendant (System.Windows.Media.Visual descendant);
member this.TransformToDescendant : System.Windows.Media.Visual -> System.Windows.Media.GeneralTransform
Public Function TransformToDescendant (descendant As Visual) As GeneralTransform

パラメーター

descendant
Visual Visual Visual Visual

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

戻り値

例外

ビジュアルは、descendant ビジュアルの先祖ではありません。The visual is not an ancestor of the descendant visual.

ビジュアル オブジェクトは相対的ではありません。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>

次のコード例を使用する方法を示しています、TransformToDescendantのオフセットを取得するメソッドをStackPanelその子の基準としたTextBlockします。The following code example shows how to use the TransformToDescendant 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.TransformToDescendant(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.TransformToDescendant(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.

適用対象