BitmapImage.DecodePixelWidth 屬性

定義

取得或設定影像解碼成的寬度 (以像素為單位)。Gets or sets the width, in pixels, that the image is decoded to.

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

屬性值

影像解碼成的寬度 (以像素為單位)。The width, in pixels, that the image is decoded to. 預設值為 0。The default value is 0.

範例

下列程式碼範例示範如何使用程式碼DecodePixelWidth來設定屬性。The following code example demonstrates how to set the DecodePixelWidth 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);
' 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)

備註

如果DecodePixelHeight也設定了, 則會忽略點陣圖的外觀比例。If DecodePixelHeight is also set, the aspect ratio of the bitmap is ignored. 如果DecodePixelHeight未設定, 外觀比例會維持不變。If DecodePixelHeight is not set, the aspect ratio remains the same.

JPEGJPEGPortable Network Graphics (PNG)Portable Network Graphics (PNG)編解碼器會以原生方式將影像解碼成指定的大小; 其他編解碼器會以原始大小解碼影像, 並將影像調整成所需的大小。The JPEGJPEG and Portable Network Graphics (PNG)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.

相依性屬性資訊Dependency Property Information

識別碼欄位Identifier field DecodePixelWidthProperty
中繼資料屬性設定為trueMetadata properties set to true None

適用於

另請參閱