BitmapCreateOptions Enum
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Anger initieringsalternativ för bitmappsbilder.
Den här uppräkningen stöder en bitvis kombination av dess medlemsvärden.
public enum class BitmapCreateOptions[System.Flags]
public enum BitmapCreateOptions[<System.Flags>]
type BitmapCreateOptions = Public Enum BitmapCreateOptions- Arv
- Attribut
Fält
| Name | Värde | Description |
|---|---|---|
| None | 0 | Nej BitmapCreateOptions har angetts. Det här är standardvärdet. |
| PreservePixelFormat | 1 | Ser till att PixelFormat en fil lagras i är densamma som den läses in till. |
| DelayCreation | 2 | Gör att ett BitmapSource objekt fördröjer initieringen tills det är nödvändigt. Detta är användbart när du hanterar samlingar med bilder. |
| IgnoreColorProfile | 4 | Gör att en BitmapSource ignorerar en inbäddad färgprofil. |
| IgnoreImageCache | 8 | Läser in bilder utan att använda en befintlig avbildningscache. Det här alternativet bör bara väljas när bilder i en cache behöver uppdateras. |
Exempel
I följande exempel visas hur du instansierar ett BitmapImage och anger ett BitmapCreateOptions uppräkningsvärde.
// 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)
Kommentarer
Om PreservePixelFormat inte har angetts väljs avbildningen PixelFormat av systemet beroende på vad systemet avgör ger bästa möjliga prestanda. Om du aktiverar det här alternativet bevaras filformatet, men det kan leda till sämre prestanda.
Om IgnoreColorProfile anges returnerar anrop till metoder som CopyPixels(Array, Int32, Int32) inte färgkorrigerade bitar.
Om IgnoreImageCache har angetts ersätts alla befintliga poster i avbildningscacheminnet även om de delar samma Uri.