BitmapCreateOptions Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie les options d’initialisation pour les images bitmap.
Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.
public enum class BitmapCreateOptions[System.Flags]
public enum BitmapCreateOptions[<System.Flags>]
type BitmapCreateOptions = Public Enum BitmapCreateOptions- Héritage
- Attributs
Champs
| DelayCreation | 2 | Fait qu’un objet BitmapSource diffère l’initialisation jusqu’à ce qu’elle soit nécessaire. Ceci est utile quand vous traitez des collections d’images. |
| IgnoreColorProfile | 4 | Fait qu’un BitmapSource ignore un profil de couleurs incorporé. |
| IgnoreImageCache | 8 | Charge des images sans utiliser un cache d’images existantes. Cette option doit être sélectionnée seulement quand des images d’un cache doivent être actualisées. |
| None | 0 | Aucun BitmapCreateOptions n’est spécifié. Il s’agit de la valeur par défaut. |
| PreservePixelFormat | 1 | Garantit que le PixelFormat où est stocké un fichier est le même que celui dans lequel il est chargé. |
Exemples
L’exemple suivant montre comment instancier un BitmapImage et spécifier une BitmapCreateOptions valeur d’énumération.
// 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)
Remarques
Si PreservePixelFormat elle n’est pas définie, l’image PixelFormat est choisie par le système en fonction de ce que le système détermine génère les meilleures performances. L’activation de cette option conserve le format de fichier, mais peut entraîner des performances moindres.
Si IgnoreColorProfile elle est définie, les appels aux méthodes telles que CopyPixels(Array, Int32, Int32) ne retournent pas de bits corrigés par couleur.
Si IgnoreImageCache elle est définie, toutes les entrées existantes dans le cache d’images sont remplacées même si elles partagent le même Uri.