BitmapCreateOptions Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt Initialisierungsoptionen für Bitmapbilder an.
Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.
public enum class BitmapCreateOptions[System.Flags]
public enum BitmapCreateOptions[<System.Flags>]
type BitmapCreateOptions = Public Enum BitmapCreateOptions- Vererbung
- Attribute
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| None | 0 | Nein BitmapCreateOptions ist angegeben. Dies ist der Standardwert. |
| PreservePixelFormat | 1 | Stellt sicher, dass die PixelFormat Datei in der Datei gespeichert ist, in die sie geladen wird. |
| DelayCreation | 2 | Bewirkt, dass ein BitmapSource Objekt die Initialisierung verzögert, bis es erforderlich ist. Dies ist hilfreich beim Umgang mit Sammlungen von Bildern. |
| IgnoreColorProfile | 4 | Bewirkt, dass ein BitmapSource eingebettetes Farbprofil ignoriert wird. |
| IgnoreImageCache | 8 | Lädt Bilder, ohne einen vorhandenen Bildcache zu verwenden. Diese Option sollte nur ausgewählt werden, wenn Bilder in einem Cache aktualisiert werden müssen. |
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie ein BitmapImage Enumerationswert instanziieren und angegeben BitmapCreateOptions wird.
// 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)
Hinweise
Wenn PreservePixelFormat das Bild nicht festgelegt ist, wird das PixelFormat Bild vom System ausgewählt, je nachdem, was das System bestimmt, die beste Leistung. Wenn Sie diese Option aktivieren, bleibt das Dateiformat erhalten, kann jedoch zu einer geringeren Leistung führen.
Wenn IgnoreColorProfile dieser Wert festgelegt ist, werden Aufrufe von Methoden wie z CopyPixels(Array, Int32, Int32) . B. keine farbkorrekturen Bits zurückgegeben.
Falls IgnoreImageCache festgelegt, werden alle vorhandenen Einträge im Bildcache ersetzt, auch wenn sie denselben Uriteilen.
