Compartilhar via


Visual.TransformToDescendant(Visual) Método

Definição

Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual até 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

O Visual para o qual as coordenadas são transformadas.

Retornos

GeneralTransform

Um valor do tipo GeneralTransform.

Exceções

descendant é null.

O visual especificado não é um ancestral do visual descendant.

Os objetos visuais não estão relacionados.

Exemplos

O exemplo de marcação a seguir mostra um TextBlock que está contido em um StackPanel objeto.

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

O exemplo de código a seguir mostra como usar o TransformToDescendant método para recuperar o deslocamento do StackPanel relativo ao filho TextBlock. Os valores de deslocamento estão contidos no valor retornado 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 leva em conta os Margin valores de todos os objetos. Nesse caso, X é -4 e Y é -4. Os valores de deslocamento são valores negativos porque o objeto pai é deslocado negativamente em relação ao objeto filho.

Aplica-se a