.NET Framework Class Library
UIElement..::.RenderTransformOrigin Property

Gets or sets the center point of any possible render transform declared by RenderTransform, relative to the bounds of the element. This is a dependency property.

Namespace:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
Syntax

Visual Basic (Declaration)
Public Property RenderTransformOrigin As Point
Visual Basic (Usage)
Dim instance As UIElement
Dim value As Point

value = instance.RenderTransformOrigin

instance.RenderTransformOrigin = value
C#
public Point RenderTransformOrigin { get; set; }
Visual C++
public:
property Point RenderTransformOrigin {
    Point get ();
    void set (Point value);
}
JScript
public function get RenderTransformOrigin () : Point
public function set RenderTransformOrigin (value : Point)
XAML Property Element Usage
<object>
  <object.RenderTransformOrigin>
    <Point X="xOrigin" Y="yOrigin"/>
  </object.RenderTransformOrigin>
</object>
XAML Attribute Usage
<object RenderTransformOrigin="xOrigin, yOrigin"/>

XAML Values

xOrigin

The horizontal origin factor. This is typically given as a value between 0 and 1. See Remarks.

yOrigin

The vertical origin factor. This is typically given as a value between 0 and 1. See Remarks.

Property Value

Type: System.Windows..::.Point
The value that declares the render transform. The default value is a Point with coordinates (0,0).
Dependency Property Information

Identifier field

RenderTransformOriginProperty

Metadata properties set to true

None

Remarks

RenderTransformOrigin has a somewhat nonstandard use of the Point structure value, in that the Point does not represent an absolute location in a coordinate system. Instead, values between 0 and 1 are interpreted as a factor for the range of the current element in each x,y axis. For example, (0.5,0.5) will cause the render transform to be centered on the element, or (1,1) would place the render transform at the bottom right corner of the element. NaN is not an accepted value.

Values beyond 0 and 1 are also accepted, and will result in more unconventional transform effects. For instance, if you set RenderTransformOrigin to be (5,5), and then apply a RotateTransform, the rotation point will be well outside the bounds of the element itself. The transform will spin your element around in a big circle that originates beyond bottom right. The origin might be somewhere inside its parent element and could possibly be possibly out of frame or view. Negative point values are similar, these will go beyond the top left bounds.

Render transforms do not affect layout, and are typically used to animate or apply a temporary effect to an element.

Examples

The following example builds up elements in code, applies a RenderTransformOrigin, and then applies a RenderTransform.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 3.5, 3.0
See Also

Reference

Other Resources

Tags :


Page view tracker