BitmapCreateOptions Enumeración

  • Referencia

Definición

Espacio de nombres:
System.Windows.Media.Imaging
Ensamblado:
PresentationCore.dll

Especifica opciones de inicialización para las imágenes de mapa de bits.

Esta enumeración admite una combinación bit a bit de sus valores de miembro.

public enum class BitmapCreateOptions
[System.Flags]
public enum BitmapCreateOptions
[<System.Flags>]
type BitmapCreateOptions = 
Public Enum BitmapCreateOptions
Herencia
Object
ValueType
Enum
BitmapCreateOptions
Atributos
FlagsAttribute

Campos

DelayCreation 2

Provoca que un objeto BitmapSource retrase la inicialización hasta que sea necesario. Esto es útil cuando se trabaja con colecciones de imágenes.
IgnoreColorProfile 4

Provoca que un elemento BitmapSource omita un perfil de color incrustado.
IgnoreImageCache 8

Carga imágenes sin usar una memoria caché de imágenes existente. Esta opción solo debe seleccionarse cuando deben actualizarse las imágenes de una memoria caché.
None 0

No se han especificado BitmapCreateOptions. Este es el valor predeterminado.
PreservePixelFormat 1

Garantiza que el elemento PixelFormat en el que se almacena un archivo es el mismo que en el que se carga.

Ejemplos

En el ejemplo siguiente se muestra cómo crear una instancia BitmapImage de y especificar un BitmapCreateOptions valor de enumeración.

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

Comentarios

Si PreservePixelFormat no se establece, el sistema elige el PixelFormat de la imagen en función de lo que determine el sistema producirá el mejor rendimiento. Al habilitar esta opción, se conserva el formato de archivo, pero puede dar lugar a un rendimiento menor.

Si IgnoreColorProfile se establece, las llamadas a métodos como CopyPixels(Array, Int32, Int32) no devolverán bits con corrección de color.

Si IgnoreImageCache se establece , las entradas existentes en la caché de imágenes se reemplazan incluso si comparten el mismo Uri.

Se aplica a

Consulte también