VisualTreeHelper.GetOffset(Visual) Method

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

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

Parameters

reference

Visual

The Visual whose offset is returned.

Returns

Vector

A Vector that represents the offset value of the Visual.

Examples

The following markup example shows a TextBlock that is defined with Margin value of 4.

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

The following code example shows how to use the GetOffset method to retrieve the offset of the TextBlock. 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)

The offset takes into account the Margin value. In this case, X is 4, and Y is 4.

Remarks

The returned offset value is relative to the parent of the Visual. If you want to return an offset value that is not relative to the parent of a Visual, use the TransformToAncestor method.