VisualTreeHelper.GetOffset(Visual) Method

Reference

Definition

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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.

XAML

<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.

Applies to

Product	Versions
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Share via