BitmapCreateOptions Перечисление

Определение

Указывает параметры инициализации для точечных рисунков.Specifies initialization options for bitmap images.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

public enum class BitmapCreateOptions
[System.Flags]
public enum BitmapCreateOptions
[<System.Flags>]
type BitmapCreateOptions = 
Public Enum BitmapCreateOptions
Наследование
BitmapCreateOptions
Атрибуты

Поля

DelayCreation 2

Заставляет объект BitmapSource отложить инициализацию до необходимого момента.Causes a BitmapSource object to delay initialization until it is necessary. Это используется при работе с коллекциями изображений.This is useful when dealing with collections of images.

IgnoreColorProfile 4

Заставляет BitmapSource игнорировать внедренный цветовой профиль.Causes a BitmapSource to ignore an embedded color profile.

IgnoreImageCache 8

Загружает изображение без использования существующего кэша изображений.Loads images without using an existing image cache. Этот параметр следует использовать только в том случае, когда необходимо обновить изображения в кэше.This option should only be selected when images in a cache need to be refreshed.

None 0

BitmapCreateOptions не указан.No BitmapCreateOptions are specified. Это значение по умолчанию.This is the default value.

PreservePixelFormat 1

Проверяет, хранится ли файл в том же PixelFormat, в который он был загружен.Ensures that the PixelFormat a file is stored in is the same as it is loaded to.

Примеры

В следующем примере показано, как создать экземпляр BitmapImage и указать BitmapCreateOptions значение перечисления.The following example demonstrates how to instantiate a BitmapImage and specify a BitmapCreateOptions enumeration value.

// 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 зависимости от того, что определено системой, будет выдаваться оптимальная производительность.If PreservePixelFormat is not set, the PixelFormat of the image is chosen by the system depending on what the system determines will yield the best performance. Включение этого параметра сохраняет формат файла, но может привести к снижению производительности.Enabling this option preserves the file format but may result in lesser performance.

Если IgnoreColorProfile задано значение, вызовы методов, например, CopyPixels(Array, Int32, Int32) не будут возвращать цветовые биты.If IgnoreColorProfile is set, calls to methods such as CopyPixels(Array, Int32, Int32) will not return color-corrected bits.

Если IgnoreImageCache задано значение, все существующие записи в кэше изображений заменяются, даже если они совместно используются Uri .If IgnoreImageCache is set, any existing entries in the image cache are replaced even if they share the same Uri.

Применяется к

См. также раздел