BitmapCreateOptions Enumeration

  • Referenz

Definition

Namespace:
System.Windows.Media.Imaging
Assembly:
PresentationCore.dll

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
Object
ValueType
Enum
BitmapCreateOptions
Attribute
FlagsAttribute

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.

Gilt für

Siehe auch