Visual.TransformToVisual(Visual) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Zwraca przekształcenie, które może służyć do przekształcania współrzędnych z Visual obiektu do określonego obiektu wizualizacji.

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

Parametry

visual

Visual

Współrzędnych Visual , do których są przekształcane.

Zwraca

GeneralTransform

Wartość typu GeneralTransform.

Wyjątki

ArgumentNullException

visual to null.

InvalidOperationException

Obiekty wizualne nie są powiązane.

Przykłady

Poniższy przykład znaczników przedstawia element zawarty TextBlock w StackPanel obiekcie.

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

W poniższym przykładzie kodu pokazano, jak użyć TransformToVisual metody w celu pobrania przesunięcia względem StackPanel jego elementu podrzędnego TextBlock. Wartości przesunięcia znajdują się w zwróconej GeneralTransform wartości.

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

Przesunięcie uwzględnia Margin wartości wszystkich obiektów. W tym przypadku X wartość jest -4 i Y wynosi -4. Wartości przesunięcia to wartości ujemne, ponieważ obiekt nadrzędny jest ujemnie przesunięty względem jego obiektu podrzędnego.

Uwagi

Metody TransformToAncestor i TransformToDescendant mogą również służyć do zwracania przekształcenia dla obiektu wizualnego.