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 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
- Atributos
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.