BitmapCreateOptions 枚举

定义

命名空间:

System.Windows.Media.Imaging

程序集:

PresentationCore.dll

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

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

C#

[System.Flags]
public enum BitmapCreateOptions

继承

Object

ValueType

Enum

BitmapCreateOptions

属性

FlagsAttribute

字段

DelayCreation	2	使 BitmapSource 对象的初始化延迟到必要时才执行。 在处理图像集合时，这十分有用。
IgnoreColorProfile	4	使 BitmapSource 忽略嵌入式颜色配置文件。
IgnoreImageCache	8	在不使用现有图像缓存的情况下加载图像。 仅在需要刷新缓存中的图像时才可选择此选项。
None	0	未指定任何 BitmapCreateOptions。 这是默认值。
PreservePixelFormat	1	确保文件存储的 PixelFormat 与文件加载的格式相同。

示例

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

C#

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

注解

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

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

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

适用于

另请参阅

• BitmapImage
• BitmapCacheOption
• LateBoundBitmapDecoder