BitmapCreateOptions Enumeración

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.

C#

[System.Flags]
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.

C#

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

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

• BitmapImage
• BitmapCacheOption
• LateBoundBitmapDecoder