Visual.TransformToDescendant(Visual) Metoda

Definicja

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.

C#
public System.Windows.Media.GeneralTransform TransformToDescendant (System.Windows.Media.Visual descendant);

Parametry

descendant
Visual

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

Zwraca

GeneralTransform

Wartość typu GeneralTransform.

Wyjątki

descendant to null.

Wizualizacja nie jest elementem nadrzędnym wizualizacji descendant .

Obiekty wizualne nie są powiązane.

Przykłady

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

XAML
<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.

C#
// 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));

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.

Dotyczy

Produkt Wersje
.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
Windows Desktop 3.0, 3.1, 5, 6, 7