Udostępnij za pośrednictwem


BitmapCreateOptions Wyliczenie

Definicja

Określa opcje inicjowania obrazów map bitowych.

To wyliczenie obsługuje bitową kombinację jego wartości składowych.

public enum class BitmapCreateOptions
[System.Flags]
public enum BitmapCreateOptions
[<System.Flags>]
type BitmapCreateOptions = 
Public Enum BitmapCreateOptions
Dziedziczenie
BitmapCreateOptions
Atrybuty

Pola

DelayCreation 2

Powoduje opóźnienie inicjowania BitmapSource obiektu do momentu, gdy jest to konieczne. Jest to przydatne podczas pracy z kolekcjami obrazów.

IgnoreColorProfile 4

BitmapSource Powoduje zignorowanie osadzonego profilu koloru.

IgnoreImageCache 8

Ładuje obrazy bez użycia istniejącej pamięci podręcznej obrazów. Tę opcję należy wybrać tylko wtedy, gdy obrazy w pamięci podręcznej muszą być odświeżane.

None 0

Nie BitmapCreateOptions są określone. Jest to wartość domyślna.

PreservePixelFormat 1

Gwarantuje, że PixelFormat plik jest przechowywany w pliku, jest taki sam jak załadowany.

Przykłady

W poniższym przykładzie pokazano, jak utworzyć wystąpienie klasy BitmapImage i określić BitmapCreateOptions wartość wyliczenia.

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

Uwagi

Jeśli PreservePixelFormat nie zostanie ustawiona, obraz zostanie wybrany przez system w zależności od tego, PixelFormat co system określi, zapewni najlepszą wydajność. Włączenie tej opcji zachowuje format pliku, ale może spowodować obniżenie wydajności.

Jeśli IgnoreColorProfile jest ustawiona, wywołania metod, takich jak CopyPixels(Array, Int32, Int32) nie będą zwracać bitów skorygowanych kolorami.

Jeśli IgnoreImageCache jest ustawiona, wszystkie istniejące wpisy w pamięci podręcznej obrazów są zastępowane nawet wtedy, gdy współużytkują ten sam Urielement .

Dotyczy

Zobacz też