BitmapCreateOptions Énumération

Définition

Espace de noms:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

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.

C#

[System.Flags]
public enum BitmapCreateOptions

Héritage

Object

ValueType

Enum

BitmapCreateOptions

Attributs

FlagsAttribute

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.

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

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.

S’applique à

Voir aussi

• BitmapImage
• BitmapCacheOption
• LateBoundBitmapDecoder