BitmapCreateOptions Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica las opciones de inicialización de 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
- Atributos
Campos
| Nombre | Valor | Description |
|---|---|---|
| None | 0 | No BitmapCreateOptions se especifican. Este es el valor predeterminado. |
| PreservePixelFormat | 1 | Garantiza que el PixelFormat archivo se almacena en es el mismo en el que se carga. |
| DelayCreation | 2 | Hace que un BitmapSource objeto retrase la inicialización hasta que sea necesario. Esto resulta útil al tratar con colecciones de imágenes. |
| IgnoreColorProfile | 4 | Hace que se BitmapSource omita un perfil de color incrustado. |
| IgnoreImageCache | 8 | Carga imágenes sin usar una caché de imágenes existente. Esta opción solo debe seleccionarse cuando es necesario actualizar las imágenes de una memoria caché. |
Ejemplos
En el ejemplo siguiente se muestra cómo crear instancias 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 PixelFormat sistema elige el de la imagen en función de lo que determine el sistema producirá el mejor rendimiento. La habilitación de esta opción 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 corregidos por colores.
Si IgnoreImageCache se establece, las entradas existentes de la caché de imágenes se reemplazan incluso si comparten el mismo Uri.