LateBoundBitmapDecoder.Frames Propriedade

Definição

Namespace:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

Obtém o conteúdo de um quadro individual dentro de um bitmap.

public:
 virtual property System::Collections::ObjectModel::ReadOnlyCollection<System::Windows::Media::Imaging::BitmapFrame ^> ^ Frames { System::Collections::ObjectModel::ReadOnlyCollection<System::Windows::Media::Imaging::BitmapFrame ^> ^ get(); };

public override System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Media.Imaging.BitmapFrame> Frames { get; }

member this.Frames : System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Media.Imaging.BitmapFrame>

Public Overrides ReadOnly Property Frames As ReadOnlyCollection(Of BitmapFrame)

Valor da propriedade

ReadOnlyCollection<BitmapFrame>

Uma instância de BitmapFrame. Esta propriedade não tem valor padrão.

Exemplos

O exemplo a seguir demonstra como usar um BitmapFrame como um BitmapSource.

// Open a Stream and decode a TIFF image
Stream imageStreamSource = new FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read);
TiffBitmapDecoder decoder = new TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource = decoder.Frames[0];

// Draw the Image
Image myImage1 = new Image();
myImage1.Source = bitmapSource;
myImage1.Stretch = Stretch.None;
myImage1.Margin = new Thickness(20);

' Open a Stream and decode a TIFF image
Dim imageStreamSource As New FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource As BitmapSource = decoder.Frames(0)

' Draw the Image
Dim myImage1 As New Image()
myImage1.Source = bitmapSource
myImage1.Stretch = Stretch.None
myImage1.Margin = New Thickness(20)

Comentários

Como um LateBoundBitmapDecoder é baixado de forma assíncrona, é possível que a coleção subjacente seja Frames alterada depois que o conteúdo for baixado e decodificado. Enquanto o conteúdo é baixado, a coleção sempre retorna pelo menos um item. Quando o download e a decodificação são concluídos, o BitmapFrame conteúdo subjacente é alterado automaticamente. Em outras palavras, somente o objeto de coleção pode mudar; o objeto de quadro real permanece o mesmo.

Qualquer quadro obtido de um LateBoundBitmapDecoder tempo que a imagem estiver baixando retornará uma largura/altura até 1,1 que os quadros terminem de ser baixados.

Somente as imagens TIFF (Formato de Arquivo de Imagem Marcada) e GIF (Formato de Intercâmbio gráfico) dão suporte a mais de um quadro.

Todos os BitmapFrame objetos que essa propriedade retorna estão congelados.

Confira também

• BitmapFrame