Partilhar via


BitmapCreateOptions Enumeração

Definição

Especifica as opções de inicialização para imagens 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
BitmapCreateOptions
Atributos

Campos

DelayCreation 2

Faz com que um objeto BitmapSource 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 ignore um perfil de cor incorporado.

IgnoreImageCache 8

Carrega imagens sem usar um cache de imagem existente. Esta opção deve ser selecionada apenas quando as imagens em um cache precisarem ser atualizadas.

None 0

Nenhum BitmapCreateOptions é especificado. Este é o valor padrão.

PreservePixelFormat 1

Garante que o PixelFormat no qual um arquivo é armazenado seja o mesmo ao qual ele é carregado.

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 do 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 imagens serão substituídas mesmo que compartilhem o mesmo Uri.

Aplica-se a

Confira também