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
| DelayCreation | 2 | Bewirkt, dass ein BitmapSource-Objekt die Initialisierung verzögert, bis sie erforderlich ist. Dies ist beim Umgang mit Bildauflistungen nützlich. |
| IgnoreColorProfile | 4 | Bewirkt, dass eine BitmapSource ein eingebettetes Farbprofil ignoriert. |
| IgnoreImageCache | 8 | Lädt Bilder ohne Verwendung eines vorhandenen Bildcaches. Diese Option sollte nur ausgewählt werden, wenn Bilder in einem Cache aktualisiert werden müssen. |
| None | 0 | Es sind keine BitmapCreateOptions angegeben. Dies ist der Standardwert. |
| PreservePixelFormat | 1 | Stellt sicher, dass das PixelFormat, in dem eine Datei gespeichert ist, demjenigen entspricht, in das sie geladen wird. |
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie ein BitmapImage BitmapCreateOptions Enumerationswert instanziieren und angegeben 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 das Bild nicht festgelegt ist, wird das PixelFormat Bild vom System gewählt, je PreservePixelFormat nachdem, was das System bestimmt, die beste Leistung. Die Aktivierung dieser Option behält das Dateiformat bei, kann jedoch zu einer geringeren Leistung führen.
Wenn IgnoreColorProfile festgelegt ist, werden Aufrufe von Methoden wie z CopyPixels(Array, Int32, Int32) . B. keine farbkorrekturen Bits zurückgegeben.
Wenn IgnoreImageCache festgelegt ist, werden vorhandene Einträge im Bildcache ersetzt, auch wenn sie dasselbe Uriteilen.