BitmapImage.Rotation Property (System.Windows.Media.Imaging)

.NET Framework Class Library

BitmapImage..::.Rotation Property

Gets or sets the angle that this BitmapImage is rotated to. This is a dependency property.

Namespace: System.Windows.Media.Imaging
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 Rotation As Rotation

Visual Basic (Usage)

Dim instance As BitmapImage
Dim value As Rotation

value = instance.Rotation

instance.Rotation = value

public Rotation Rotation { get; set; }

Visual C++

public:
property Rotation Rotation {
    Rotation get ();
    void set (Rotation value);
}

JScript

public function get Rotation () : Rotation
public function set Rotation (value : Rotation)

XAML Attribute Usage

<object Rotation="Rotation" .../>

Property Value

Type: System.Windows.Media.Imaging..::.Rotation
The rotation that is used for the BitmapImage. The default is Rotate0.

Dependency Property Information

Identifier field	RotationProperty
Metadata properties set to true	None

Remarks

Rotation is performed after scaling. This means that an image that has a Rotation of Rotate90, a DecodePixelWidth of 10, and DecodePixelHeight of 5 will result in an image that has a width of 5 and a height of 10.

Examples

The following code example demonstrates how to rotate an image by using Extensible Application Markup Language (XAML) and code.

XAML

<Image Width="150" Margin="5" Grid.Column="0" Grid.Row="1">
  <Image.Source>
    <TransformedBitmap Source="/sampleImages/watermelon.jpg" >
      <TransformedBitmap.Transform>
        <RotateTransform Angle="90"/>
      </TransformedBitmap.Transform>
    </TransformedBitmap>
  </Image.Source>
</Image>

Visual Basic

' Create Image element.
Dim rotated90 As New Image()
rotated90.Width = 150

' Create the TransformedBitmap to use as the Image source.
Dim tb As New TransformedBitmap()

' Create the source to use as the tb source.
Dim bi As New BitmapImage()
bi.BeginInit()
bi.UriSource = New Uri("sampleImages/watermelon.jpg", UriKind.RelativeOrAbsolute)
bi.EndInit()

' Properties must be set between BeginInit and EndInit calls.
tb.BeginInit()
tb.Source = bi
' Set image rotation.
Dim transform As New RotateTransform(90)
tb.Transform = transform
tb.EndInit()
' Set the Image source.
rotated90.Source = tb

// Create Image element.
Image rotated90 = new Image();
rotated90.Width = 150;

// Create the TransformedBitmap to use as the Image source.
TransformedBitmap tb = new TransformedBitmap();

// Create the source to use as the tb source.
BitmapImage bi = new BitmapImage();
bi.BeginInit();
bi.UriSource = new Uri(@"sampleImages/watermelon.jpg", UriKind.RelativeOrAbsolute);
bi.EndInit();

// Properties must be set between BeginInit and EndInit calls.
tb.BeginInit();
tb.Source = bi;
// Set image rotation.
RotateTransform transform = new RotateTransform(90);
tb.Transform = transform;
tb.EndInit();
// Set the Image source.
rotated90.Source = tb;

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

Reference

BitmapImage Class

BitmapImage Members

System.Windows.Media.Imaging Namespace

Rotation