Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

Visual.TransformToVisual, méthode

Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans l'objet visuel spécifié.

Espace de noms :  System.Windows.Media
Assembly :  PresentationCore (dans PresentationCore.dll)

public GeneralTransform TransformToVisual(
	Visual visual
)

Paramètres

visual
Type : System.Windows.Media.Visual
Visual dont les coordonnées sont transformées.

Valeur de retour

Type : System.Windows.Media.GeneralTransform
Une valeur de type GeneralTransform.

ExceptionCondition
ArgumentNullException

visual est null.

InvalidOperationException

Les objets visuels ne sont pas liés.

Les méthodes TransformToAncestor et TransformToDescendant peuvent également être utilisées pour retourner une transformation pour un objet visuel.

L'exemple de balise suivant montre un TextBlock contenu dans un objet StackPanel.


<StackPanel Name="myStackPanel" Margin="8">
  <TextBlock Name="myTextBlock" Margin="4" Text="Hello, world" />
</StackPanel>


L'exemple de code suivant montre comment utiliser la méthode TransformToVisual pour récupérer le décalage du StackPanel par rapport à son TextBlock enfant. Les valeurs de décalage sont indiquées dans la valeur GeneralTransform retournée.


// 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));


Le décalage tient compte des valeurs Margin de tous les objets. Dans ce cas, X est égal à -4 et Y à -4. Les valeurs de décalage sont négatives car l'objet parent est décalé vers des valeurs négatives par rapport à son objet enfant.

.NET Framework

Pris en charge dans : 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Afficher: