Język

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 obiektu na określony obiekt wizualny potomny.

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ędne Visual , do których są przekształcane.

Zwraca

GeneralTransform

Wartość typu GeneralTransform.

Wyjątki

ArgumentNullException

Parametr descendant ma wartość 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 obiekt TextBlock zawarty w StackPanel obiekcie.

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

Poniższy przykład kodu pokazuje, jak użyć TransformToDescendant metody w celu pobrania przesunięcia względem elementu podrzędnego StackPanelTextBlock. Wartości przesunięcia są zawarte 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ść to -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