BitmapImage.DecodePixelHeight Propriedade

Definição

Obtém ou define a altura, em pixels, para qual a imagem é decodificada.

public:
 property int DecodePixelHeight { int get(); void set(int value); };
public int DecodePixelHeight { get; set; }
member this.DecodePixelHeight : int with get, set
Public Property DecodePixelHeight As Integer

Valor da propriedade

Int32

A altura, em pixels, para qual a imagem é decodificada. O valor padrão é 0.

Exemplos

O exemplo de código a seguir demonstra como definir a DecodePixelHeight propriedade usando código.

// 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);
' Define a BitmapImage.
Dim myImage As New Image()
Dim bi As 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)

Comentários

Se DecodePixelWidth também estiver definido, a taxa de proporção do bitmap será ignorada. Se DecodePixelWidth não estiver definido, a taxa de proporção permanecerá a mesma.

Os codecs JPEG e PNG (Portable Network Graphics) decodificam a imagem nativamente para o tamanho especificado; outros codecs decodificam a imagem em seu tamanho original e dimensionam a imagem para o tamanho desejado.

Informações da propriedade de dependência

Campo identificador DecodePixelHeightProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a

Confira também