BitmapCreateOptions 枚举

定义

指定位图图像的初始化选项。

此枚举支持其成员值的按位组合。

public enum class BitmapCreateOptions
[System.Flags]
public enum BitmapCreateOptions
[<System.Flags>]
type BitmapCreateOptions = 
Public Enum BitmapCreateOptions
继承
BitmapCreateOptions
属性

字段

DelayCreation 2

使 BitmapSource 对象的初始化延迟到必要时才执行。 在处理图像集合时,这十分有用。

IgnoreColorProfile 4

使 BitmapSource 忽略嵌入式颜色配置文件。

IgnoreImageCache 8

在不使用现有图像缓存的情况下加载图像。 仅在需要刷新缓存中的图像时才可选择此选项。

None 0

未指定任何 BitmapCreateOptions。 这是默认值。

PreservePixelFormat 1

确保文件存储的 PixelFormat 与文件加载的格式相同。

示例

下面的示例演示如何实例化 BitmapImage 并指定 BitmapCreateOptions 枚举值。

// 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)

注解

如果未 PreservePixelFormat 设置, PixelFormat 系统会根据系统确定的内容选择映像,从而产生最佳性能。 启用此选项会保留文件格式,但可能会导致性能降低。

如果 IgnoreColorProfile 已设置,则调用方法(如 CopyPixels(Array, Int32, Int32) 不会返回颜色更正位)。

如果 IgnoreImageCache 已设置,即使映像缓存中的任何现有条目共享相同 Uri,也会替换这些条目。

适用于

另请参阅