BitmapCreateOptions 枚举
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
指定位图图像的初始化选项。
此枚举支持其成员值的按位组合。
public enum class BitmapCreateOptions[System.Flags]
public enum BitmapCreateOptions[<System.Flags>]
type BitmapCreateOptions = Public Enum 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，也会替换这些条目。