Visual.TransformToDescendant(Visual) Méthode

Définition

Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans le descendant spécifié de l'objet visuel.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

Paramètres

descendant
Visual

Le Visual auquel les coordonnées sont transformées.The Visual to which the coordinates are transformed.

Retours

GeneralTransform

Valeur de type GeneralTransform.A value of type GeneralTransform.

Exceptions

descendant a la valeur null.descendant is null.

L'objet visuel n'est pas un ancêtre de l'objet visuel descendant.The visual is not an ancestor of the descendant visual.

Les objets visuels ne sont pas liés.The visual objects are not related.

Exemples

L’exemple de balisage suivant montre un TextBlock qui est contenu dans un StackPanel objet.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>

L’exemple de code suivant montre comment utiliser la TransformToDescendant méthode pour récupérer l’offset du StackPanel relatif à son enfant TextBlock .The following code example shows how to use the TransformToDescendant method to retrieve the offset of the StackPanel relative to its child TextBlock. Les valeurs de décalage sont contenues dans la valeur retournée 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))

Le décalage prend en compte les Margin valeurs pour tous les objets.The offset takes into account the Margin values for all objects. Dans ce cas, X est-4 et Y est-4.In this case, X is -4, and Y is -4. Les valeurs de décalage sont des valeurs négatives, car l’objet parent est décalé négativement par rapport à son objet enfant.The offset values are negative values because the parent object is negatively offset relative to its child object.

S’applique à