BitmapCreateOptions Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica as opções de inicialização para imagens de bitmap.
Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.
public enum class BitmapCreateOptions[System.Flags]
public enum BitmapCreateOptions[<System.Flags>]
type BitmapCreateOptions = Public Enum BitmapCreateOptions- Herança
- Atributos
Campos
| Nome | Valor | Description |
|---|---|---|
| None | 0 | Não BitmapCreateOptions são especificados. Este é o valor padrão. |
| PreservePixelFormat | 1 | Garante que o PixelFormat arquivo em que um arquivo está armazenado seja o mesmo que ele é carregado. |
| DelayCreation | 2 | Faz com que um BitmapSource objeto atrase a inicialização até que seja necessário. Isso é útil ao lidar com coleções de imagens. |
| IgnoreColorProfile | 4 | Faz com que um BitmapSource perfil de cores inserido ignore. |
| IgnoreImageCache | 8 | Carrega imagens sem usar um cache de imagem existente. Essa opção só deve ser selecionada quando as imagens em um cache precisarem ser atualizadas. |
Exemplos
O exemplo a seguir demonstra como criar uma BitmapImage instância 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)
Comentários
Se PreservePixelFormat não estiver definido, a PixelFormat imagem será escolhida pelo sistema dependendo do que o sistema determinar produzirá o melhor desempenho. Habilitar essa opção preserva o formato de arquivo, mas pode resultar em um desempenho menor.
Se IgnoreColorProfile estiver definido, as chamadas para métodos como CopyPixels(Array, Int32, Int32) não retornarão bits corrigidos por cor.
Se IgnoreImageCache estiver definido, todas as entradas existentes no cache de imagem serão substituídas mesmo que compartilhem o mesmo Uri.