Visual.TransformToVisual(Visual) Método

Referência

Definição

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual até o objeto visual especificado.

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

Parâmetros

visual: Visual

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

Retornos

GeneralTransform

Um valor do tipo GeneralTransform.

Exceções

ArgumentNullException

visual é null.

InvalidOperationException

Os objetos visuais não estão relacionados.

Exemplos

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

XAML

<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 TransformToVisual método para recuperar o deslocamento do StackPanel em relação ao seu 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.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))

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.

Comentários

Os TransformToAncestor métodos e TransformToDescendant também podem ser usados para retornar uma transformação para um objeto visual.

Aplica-se a

Produto	Versões
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Compartilhar via