Visual.TransformToVisual(Visual) Yöntem

Tanım

Ad Alanı:

System.Windows.Media

Bütünleştirilmiş Kod:

PresentationCore.dll

Koordinatları öğesinden Visual belirtilen görsel nesnesine dönüştürmek için kullanılabilecek bir dönüşüm döndürür.

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

Parametreler

visual

Visual

Visual Koordinatların dönüştürüldüğü yer.

Döndürülenler

GeneralTransform

türünde GeneralTransformbir değer.

Özel durumlar

ArgumentNullException

visual, null değeridir.

InvalidOperationException

Görsel nesneler ilişkili değildir.

Örnekler

Aşağıdaki işaretleme örneği, bir TextBlock nesnenin içinde yer alan bir StackPanel öğesini gösterir.

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

Aşağıdaki kod örneği, öğesinin alt TextBlocköğesine TransformToVisual göreli uzaklığını almak için yönteminin StackPanel nasıl kullanılacağını gösterir. Uzaklık değerleri, döndürülen GeneralTransform değerin içinde yer alır.

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

Uzaklık, tüm nesnelerin değerlerini dikkate Margin alır. Bu durumda, X -4 ve Y -4 olur. Üst nesne alt nesnesine göre negatif olarak uzaklık olduğundan uzaklık değerleri negatif değerlerdir.

Açıklamalar

ve TransformToAncestorTransformToDescendant yöntemleri, görsel bir nesne için dönüşüm döndürmek için de kullanılabilir.