Visual.TransformToAncestor 方法

定義

命名空間:

System.Windows.Media

組件:

PresentationCore.dll

傳回轉換，這個轉換可用來將 Visual 的座標轉換為視覺物件的指定祖系。

多載

TransformToAncestor(Visual3D)	傳回轉換，這個轉換可用來將 Visual 的座標轉換為視覺物件的指定 Visual3D 祖系。
TransformToAncestor(Visual)	傳回轉換，這個轉換可用來將 Visual 的座標轉換為視覺物件的指定 Visual 祖系。

TransformToAncestor(Visual3D)

傳回轉換，這個轉換可用來將 Visual 的座標轉換為視覺物件的指定 Visual3D 祖系。

public:
 System::Windows::Media::Media3D::GeneralTransform2DTo3D ^ TransformToAncestor(System::Windows::Media::Media3D::Visual3D ^ ancestor);

public System.Windows.Media.Media3D.GeneralTransform2DTo3D TransformToAncestor (System.Windows.Media.Media3D.Visual3D ancestor);

member this.TransformToAncestor : System.Windows.Media.Media3D.Visual3D -> System.Windows.Media.Media3D.GeneralTransform2DTo3D

Public Function TransformToAncestor (ancestor As Visual3D) As GeneralTransform2DTo3D

參數

ancestor

Visual3D

座標會轉換為 Visual3D。

傳回

GeneralTransform2DTo3D

轉換，可用來將座標從 Visual 轉換為視覺物件之指定的 Visual3D 上階。

TransformToAncestor(Visual)

傳回轉換，這個轉換可用來將 Visual 的座標轉換為視覺物件的指定 Visual 祖系。

public:
 System::Windows::Media::GeneralTransform ^ TransformToAncestor(System::Windows::Media::Visual ^ ancestor);

public System.Windows.Media.GeneralTransform TransformToAncestor (System.Windows.Media.Visual ancestor);

member this.TransformToAncestor : System.Windows.Media.Visual -> System.Windows.Media.GeneralTransform

Public Function TransformToAncestor (ancestor As Visual) As GeneralTransform

參數

ancestor

Visual

座標會轉換為 Visual。

傳回

GeneralTransform

型別 GeneralTransform 的值。

例外狀況

ArgumentNullException

ancestor 為 null。

ArgumentException

ancestor 不是視覺物件的祖系。

InvalidOperationException

這些視覺物件都不會產生關聯。

範例

下列標記範例顯示巢狀于兩 StackPanel 個 TextBlock 物件內的 。

<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >
  <StackPanel Margin="16">
    <StackPanel Margin="8">
      <TextBlock Name="myTextBlock" Margin="4" Text="Hello, world" />
    </StackPanel>
  </StackPanel>
</Window>

下列程式碼範例示範如何使用 TransformToAncestor 方法來擷取相對於包含 Window 之 的位 TextBlock 移。 位移值包含在傳 GeneralTransform 回的 中。

// Return the general transform for the specified visual object.
GeneralTransform generalTransform1 = myTextBlock.TransformToAncestor(this);

// Retrieve the point value relative to the parent.
Point currentPoint = generalTransform1.Transform(new Point(0, 0));

' Return the general transform for the specified visual object.
Dim generalTransform1 As GeneralTransform = myTextBlock.TransformToAncestor(Me)

' Retrieve the point value relative to the parent.
Dim currentPoint As Point = generalTransform1.Transform(New Point(0, 0))

位移會將包含 Window 內的所有物件值納入考慮 Margin 。 在此情況下， X 為 28，且 Y 為 28。

備註

或者，您可以使用 VisualTreeHelper.GetOffset 方法來擷取相對於其父物件的位移。 位移值包含在傳 Vector 回的值內。

// Return the offset vector for the TextBlock object.
Vector vector = VisualTreeHelper.GetOffset(myTextBlock);

// Convert the vector to a point value.
Point currentPoint = new Point(vector.X, vector.Y);

' Return the offset vector for the TextBlock object.
Dim vector As Vector = VisualTreeHelper.GetOffset(myTextBlock)

' Convert the vector to a point value.
Dim currentPoint As New Point(vector.X, vector.Y)