BitmapCreateOptions Výčet
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
- 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.