BitmapCreateOptions Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает параметры инициализации для точечных рисунков.
Это перечисление поддерживает побитовую комбинацию значений его членов.
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.