Visual.TransformToDescendant(Visual) Método

Definição

Espaço de Nomes:
System.Windows.Media
Assemblagem:
PresentationCore.dll

Devolve uma transformada que pode ser usada para transformar coordenadas do Visual para o descendente do objeto visual especificado.

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

Parâmetros

descendant
Visual

As Visual coordenadas para as quais as coordenadas são transformadas.

Devoluções

GeneralTransform

Um valor do tipo GeneralTransform.

Exceções

ArgumentNullException

descendant é null.

ArgumentException

O visual não é um antepassado do descendant visual.

InvalidOperationException

Os objetos visuais não estão relacionados.

Exemplos

O exemplo seguinte de marcação mostra um TextBlock que está contido dentro de um StackPanel objeto.

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

O exemplo de código seguinte mostra como usar o TransformToDescendant método para recuperar o deslocamento do StackPanel relativo ao seu filho TextBlock. Os valores de deslocamento estão contidos no valor devolvido 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))

O deslocamento tem em conta os Margin valores de todos os objetos. Neste caso, X é -4, e Y é -4. Os valores de deslocamento são negativos porque o objeto pai está deslocado negativamente em relação ao seu objeto filho.

Aplica-se a