StorageItemThumbnail Classe

Definição

Namespace:

Windows.Storage.FileProperties

Representa a imagem em miniatura associada a um recurso do sistema (como um arquivo ou pasta).

public ref class StorageItemThumbnail sealed : IClosable, IRandomAccessStreamWithContentType

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemThumbnail final : IClosable, IRandomAccessStreamWithContentType

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemThumbnail : System.IDisposable, IRandomAccessStreamWithContentType

Public NotInheritable Class StorageItemThumbnail
Implements IDisposable, IRandomAccessStreamWithContentType

Herança

Object Platform::Object IInspectable StorageItemThumbnail

Atributos

ContractVersionAttribute

Implementações

IClosable IDisposable IContentTypeProvider IInputStream IOutputStream IRandomAccessStream IRandomAccessStreamWithContentType

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Este exemplo demonstra como obter miniaturas para arquivos.

// Set query options with filter and sort order for results
List<string> fileTypeFilter = new List<string>();
fileTypeFilter.Add(".jpg");
fileTypeFilter.Add(".png");
fileTypeFilter.Add(".bmp");
fileTypeFilter.Add(".gif");
var queryOptions = new QueryOptions(CommonFileQuery.OrderByName, fileTypeFilter);

// Create query and retrieve files.
var query = KnownFolders.PicturesLibrary.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList<StorageFile> fileList = await query.GetFilesAsync();
// Process results
foreach (StorageFile file in fileList)
{
    // Get thumbnail
    const uint requestedSize = 190;
    const ThumbnailMode thumbnailMode = ThumbnailMode.PicturesView;
    const ThumbnailOptions thumbnailOptions = ThumbnailOptions.UseCurrentScale;
    var thumbnail = await file.GetThumbnailAsync(thumbnailMode, requestedSize, thumbnailOptions);
}

Após a conclusão de GetThumbnailAsync , a miniatura obtém um objeto StorageItemThumbnail.

No exemplo, a file variável obtém um StorageFile que representa cada arquivo para o qual queremos recuperar uma miniatura. Usamos uma consulta para obter objetos StorageFile para esses arquivos (armazenados na file variável), mas você pode usar qualquer abordagem melhor para seu aplicativo obter objetos StorageFile (como por meio do seletor de arquivos).

Comentários

Você pode obter miniaturas para muitos recursos do sistema de arquivos por meio dos objetos Windows Runtime que os representam. Muitos desses objetos têm métodos ou propriedades que permitem que você obtenha (e, às vezes, defina) um StorageItemThumbnail que representa a miniatura associada a um recurso específico.

Para descobrir como obter miniaturas de um objeto Windows Runtime específico, consulte a documentação desse objeto. Por exemplo, para obter uma miniatura de um arquivo, você pode chamar um dos métodos StorageFile.getThumbnailAsync ou para obter uma miniatura para um contato, você pode usar a propriedade Contact.thumbnail .

Para obter mais exemplos de código sobre como recuperar miniaturas, consulte o exemplo de enumeração Pasta e o exemplo Miniaturas de arquivo.

Propriedades

CanRead	Obtém um valor que indica se o fluxo de miniatura pode ser lido.
CanWrite	Obtém um valor que indica se o fluxo de miniatura pode ser gravado.
ContentType	Obtém o tipo de conteúdo MIME da imagem em miniatura.
OriginalHeight	Obtém a altura original (não dimensionada) da imagem em miniatura.
OriginalWidth	Obtém a largura original (não dimensionada) da imagem em miniatura.
Position	Obtém o deslocamento de bytes do fluxo de miniatura.
ReturnedSmallerCachedSize	Obtém um valor que indica se a imagem em miniatura retornada era uma versão armazenada em cache com um tamanho menor.
Size	Obtém ou define o tamanho da imagem em miniatura.
Type	Obtém um valor que indica se a miniatura é um ícone ou uma imagem.

Métodos

CloneStream()	Cria um novo fluxo sobre a miniatura representada pelo objeto storageItemThumbnail atual.
Close()	Libera recursos do sistema expostos por um objeto Windows Runtime.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.
FlushAsync()	Libera dados de forma assíncrona em um fluxo sequencial.
GetInputStreamAt(UInt64)	Recupera os dados da imagem em miniatura como um fluxo não codificado.
GetOutputStreamAt(UInt64)	Recupera um objeto de fluxo de saída para gravar dados de imagem em miniatura em um item de armazenamento.
ReadAsync(IBuffer, UInt32, InputStreamOptions)	Retorna um objeto de leitor de bytes assíncrono.
Seek(UInt64)	Define o deslocamento do fluxo de miniatura para o valor especificado.
WriteAsync(IBuffer)	Grava dados de forma assíncrona em um fluxo sequencial.

Confira também

• StorageFile
• Exemplo de miniatura de arquivo e pasta (Windows 10)