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
| Nom | Valeur | Description |
|---|---|---|
| None | 0 | Aucune n’est BitmapCreateOptions spécifiée. Il s’agit de la valeur par défaut. |
| PreservePixelFormat | 1 | Vérifie que le PixelFormat fichier est stocké dans le même fichier qu’il est chargé. |
| DelayCreation | 2 | Provoque un retard d’initialisation d’un BitmapSource objet jusqu’à ce qu’il soit nécessaire. Cela est utile lorsque vous traitez des collections d’images. |
| IgnoreColorProfile | 4 | Entraîne l’ignorer BitmapSource d’un profil de couleur incorporé. |
| IgnoreImageCache | 8 | Charge des images sans utiliser de cache d’images existant. Cette option ne doit être sélectionnée que lorsque les images d’un cache doivent être actualisées. |
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
S’il PreservePixelFormat n’est pas défini, 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 à des 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.