Visual.TransformToVisual(Visual) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve uma transformada que pode ser usada para transformar coordenadas de para Visual 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
Devoluções
Um valor do tipo GeneralTransform.
Exceções
visual é null.
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 TransformToVisual 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.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 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.
Observações
Os TransformToAncestor métodos e TransformToDescendant também podem ser usados para devolver uma transformada para um objeto visual.