Sdílet prostřednictvím


BitmapCreateOptions Výčet

Definice

Určuje možnosti inicializace pro rastrové obrázky.

Tento výčet podporuje bitové kombinace hodnot jeho členů.

public enum class BitmapCreateOptions
[System.Flags]
public enum BitmapCreateOptions
[<System.Flags>]
type BitmapCreateOptions = 
Public Enum BitmapCreateOptions
Dědičnost
BitmapCreateOptions
Atributy

Pole

DelayCreation 2

Způsobí, BitmapSource že objekt zpozdí inicializaci, dokud nebude nutné. To je užitečné při práci s kolekcemi obrázků.

IgnoreColorProfile 4

BitmapSource Způsobí ignorování vloženého barevného profilu.

IgnoreImageCache 8

Načte obrázky bez použití existující mezipaměti imagí. Tuto možnost byste měli vybrat jenom v případě, že je potřeba aktualizovat obrázky v mezipaměti.

None 0

Nejsou zadány žádné BitmapCreateOptions . Toto je výchozí hodnota.

PreservePixelFormat 1

Zajišťuje, že PixelFormat soubor je uložený ve stejném formátu jako soubor, do kterého se načte.

Příklady

Následující příklad ukazuje, jak vytvořit instanci BitmapImage a zadat hodnotu výčtu BitmapCreateOptions .

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

Poznámky

Pokud PreservePixelFormat není nastavená, systém vybere image v závislosti na tom, co systém určí, PixelFormat zajistí nejlepší výkon. Povolení této možnosti zachová formát souboru, ale může mít za následek nižší výkon.

Pokud IgnoreColorProfile je nastavena, volání metod, jako CopyPixels(Array, Int32, Int32) je například nevrací barevně opravené bity.

Pokud IgnoreImageCache je nastavena, všechny existující položky v mezipaměti image jsou nahrazeny i v případě, že sdílejí stejné Uri.

Platí pro

Viz také