BitmapCreateOptions Enumeração
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica opções de inicialização para imagens bitmap.
Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores membro.
public enum class BitmapCreateOptions[System.Flags]
public enum BitmapCreateOptions[<System.Flags>]
type BitmapCreateOptions = Public Enum BitmapCreateOptions- Herança
- Atributos
Campos
| Name | Valor | Description |
|---|---|---|
| None | 0 | Não BitmapCreateOptions são especificados. Este é o valor padrão. |
| PreservePixelFormat | 1 | Garante que o PixelFormat ficheiro em que está armazenado é igual ao em que foi carregado. |
| DelayCreation | 2 | Faz com que um BitmapSource objeto atrase a inicialização até que seja necessário. Isto é útil quando se trata de coleções de imagens. |
| IgnoreColorProfile | 4 | Faz com que a BitmapSource ignore um perfil de cor incorporado. |
| IgnoreImageCache | 8 | Carrega imagens sem usar uma cache de imagem existente. Esta opção só deve ser selecionada quando as imagens numa cache precisam de ser atualizadas. |
Exemplos
O exemplo seguinte demonstra como instanciar um BitmapImage e especificar um BitmapCreateOptions valor de enumeração.
// 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)
Observações
Se PreservePixelFormat não estiver definido, o PixelFormat da imagem é escolhido pelo sistema consoante o que o sistema determina que resultará no melhor desempenho. Ativar esta opção preserva o formato do ficheiro, mas pode resultar em desempenho inferior.
Se IgnoreColorProfile for definido, as chamadas a métodos como CopyPixels(Array, Int32, Int32) não retornam bits corrigidos por cor.
Se IgnoreImageCache for definido, quaisquer entradas existentes na cache de imagem são substituídas mesmo que partilhem o Urimesmo .