BitmapCreateOptions Enum
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee geeft u initialisatieopties voor bitmapafbeeldingen op.
Deze opsomming ondersteunt een bitsgewijze combinatie van de waarden van de leden.
public enum class BitmapCreateOptions[System.Flags]
public enum BitmapCreateOptions[<System.Flags>]
type BitmapCreateOptions = Public Enum BitmapCreateOptions- Overname
- Kenmerken
Velden
| Name | Waarde | Description |
|---|---|---|
| None | 0 | Nee BitmapCreateOptions is opgegeven. Dit is de standaardwaarde. |
| PreservePixelFormat | 1 | Hiermee zorgt u ervoor dat het PixelFormat bestand is opgeslagen in hetzelfde als waarin het is geladen. |
| DelayCreation | 2 | Zorgt ervoor dat een BitmapSource object initialisatie vertraagt totdat het nodig is. Dit is handig bij het verwerken van verzamelingen afbeeldingen. |
| IgnoreColorProfile | 4 | Hiermee wordt een BitmapSource ingesloten kleurprofiel genegeerd. |
| IgnoreImageCache | 8 | Laadt afbeeldingen zonder een bestaande afbeeldingscache te gebruiken. Deze optie mag alleen worden geselecteerd wanneer afbeeldingen in een cache moeten worden vernieuwd. |
Voorbeelden
In het volgende voorbeeld ziet u hoe u een BitmapImage instantie maakt en een BitmapCreateOptions opsommingswaarde opgeeft.
// 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)
Opmerkingen
Als PreservePixelFormat de installatiekopieën niet zijn ingesteld, wordt de PixelFormat installatiekopieën door het systeem gekozen, afhankelijk van wat het systeem bepaalt, de beste prestaties opleveren. Als u deze optie inschakelt, blijft de bestandsindeling behouden, maar kan dit leiden tot minder prestaties.
Als IgnoreColorProfile deze optie is ingesteld, worden aanroepen naar methoden zoals CopyPixels(Array, Int32, Int32) geen door kleur gecorrigeerde bits geretourneerd.
Als IgnoreImageCache deze optie is ingesteld, worden bestaande vermeldingen in de afbeeldingscache vervangen, zelfs als ze hetzelfde Uridelen.
