Visual.TransformToVisual(Visual) Méthode

Définition

Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans l'objet visuel spécifié.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
Public Function TransformToVisual (visual As Visual) As GeneralTransform

Paramètres

visual
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

visual a la valeur null.visual is null.

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 TransformToVisual méthode pour récupérer l’offset du StackPanel relatif à son enfant TextBlock .The following code example shows how to use the TransformToVisual 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.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))

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.

Remarques

Les TransformToAncestor TransformToDescendant méthodes et peuvent également être utilisées pour retourner une transformation pour un objet visuel.The TransformToAncestor and TransformToDescendant methods can also be used to return a transform for a visual object.

S’applique à