DecodePixelHeight Property

BitmapImage.DecodePixelHeight Property

 

Gets or sets the height, in pixels, that the image is decoded to.

Namespace:   System.Windows.Media.Imaging
Assembly:  PresentationCore (in PresentationCore.dll)

public int DecodePixelHeight { get; set; }

Property Value

Type: System.Int32

The height, in pixels, that the image is decoded to. The default value is 0.

If DecodePixelWidth is also set, the aspect ratio of the bitmap is ignored. If DecodePixelWidth is not set, the aspect ratio remains the same.

The JPEG and Portable Network Graphics (PNG) codecs natively decode the image to the specified size; other codecs decode the image at its original size and scale the image to the desired size.

Identifier field

DecodePixelHeightProperty

Metadata properties set to true

None

The following code example demonstrates how to set the DecodePixelHeight property by using code.

// Define a BitmapImage.
Image myImage = new Image();
BitmapImage bi = new BitmapImage();

// Begin initialization.
bi.BeginInit();

// Set properties.
bi.CacheOption = BitmapCacheOption.OnDemand;
bi.CreateOptions = BitmapCreateOptions.DelayCreation;
bi.DecodePixelHeight = 125;
bi.DecodePixelWidth = 125;
bi.Rotation = Rotation.Rotate90;
MessageBox.Show(bi.IsDownloading.ToString());
bi.UriSource = new Uri("smiley.png", UriKind.Relative);

// End initialization.
bi.EndInit();
myImage.Source = bi;
myImage.Stretch = Stretch.None;
myImage.Margin = new Thickness(5);

.NET Framework
Available since 3.0
Windows Phone Silverlight
Available since 8.0
Return to top
Show:
© 2016 Microsoft