Partilhar via


StorageItemThumbnail Classe

Definição

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
Implementações

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.

Aplica-se a

Confira também