VisualTreeHelper.GetOffset(Visual) メソッド

定義

Visual のオフセットを返します。Returns the offset of the Visual.

public:
 static System::Windows::Vector GetOffset(System::Windows::Media::Visual ^ reference);
public static System.Windows.Vector GetOffset (System.Windows.Media.Visual reference);
static member GetOffset : System.Windows.Media.Visual -> System.Windows.Vector
Public Shared Function GetOffset (reference As Visual) As Vector

パラメーター

reference
Visual

オフセットが返される VisualThe Visual whose offset is returned.

戻り値

Vector

Vector のオフセット値を表す VisualA Vector that represents the offset value of the Visual.

次のマークアップの例は、Margin 値が4で定義されている TextBlock を示しています。The following markup example shows a TextBlock that is defined with Margin value of 4.

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

次のコード例は、GetOffset メソッドを使用して、TextBlockのオフセットを取得する方法を示しています。The following code example shows how to use the GetOffset method to retrieve the offset of the TextBlock. オフセット値は、返された Vector 値内に含まれます。The offset values are contained within the returned Vector value.

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

オフセットでは、Margin 値が考慮されます。The offset takes into account the Margin value. この場合、X は4、Y は4です。In this case, X is 4, and Y is 4.

注釈

返されるオフセット値は、Visualの親に対する相対値です。The returned offset value is relative to the parent of the Visual. Visualの親に対して相対的ではないオフセット値を返す場合は、TransformToAncestor メソッドを使用します。If you want to return an offset value that is not relative to the parent of a Visual, use the TransformToAncestor method.

適用対象