Visual.TransformToDescendant(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 elementu podrzędnego do określonego obiektu wizualnego.

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

Parametry

descendant

Visual

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

Zwraca

GeneralTransform

Wartość typu GeneralTransform.

Wyjątki

ArgumentNullException

descendant to null.

ArgumentException

Wizualizacja nie jest elementem nadrzędnym wizualizacji descendant .

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ć TransformToDescendant 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.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))

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.