Partager via


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.

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.

Retours

GeneralTransform

Valeur de type GeneralTransform.

Exceptions

descendant a la valeur null.

L'objet visuel n'est pas un ancêtre de l'objet visuel descendant.

Les objets visuels ne sont pas liés.

Exemples

L’exemple de balisage suivant montre un TextBlock élément contenu dans un StackPanel objet.

<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 le décalage du StackPanel par rapport à son enfant TextBlock. Les valeurs de décalage sont contenues dans la valeur retournée GeneralTransform .

// 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 de tous les objets. Dans ce cas, X est -4, et Y est -4. Les valeurs de décalage sont des valeurs négatives, car l’objet parent est négativement décalé par rapport à son objet enfant.

S’applique à