Visual.TransformToDescendant(Visual) Méthode

Référence

Définition

Espace de noms:: System.Windows.Media

Assembly:: PresentationCore.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

ArgumentNullException

descendant a la valeur null.

ArgumentException

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

InvalidOperationException

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 à