BitmapCreateOptions Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает параметры инициализации для растровых изображений.
Это перечисление поддерживает побитовую комбинацию значений его членов.
public enum class BitmapCreateOptions[System.Flags]
public enum BitmapCreateOptions[<System.Flags>]
type BitmapCreateOptions = Public Enum BitmapCreateOptions- Наследование
- Атрибуты
Поля
| Имя | Значение | Описание |
|---|---|---|
| None | 0 | Нет BitmapCreateOptions никаких указаний. Это значение по умолчанию. |
| PreservePixelFormat | 1 | Гарантирует, что PixelFormat файл хранится в том же виде, в который он загружается. |
| DelayCreation | 2 | Вызывает задержку BitmapSource инициализации объекта до тех пор, пока не потребуется. Это полезно при работе с коллекциями изображений. |
| IgnoreColorProfile | 4 | Вызывает BitmapSource пропуск внедренного цветового профиля. |
| IgnoreImageCache | 8 | Загружает образы без использования существующего кэша образов. Этот параметр следует выбрать только при обновлении изображений в кэше. |
Примеры
В следующем примере показано, как создать экземпляр и 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.
