StorageItemThumbnail Classe
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.
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, IRandomAccessStreamWithContentTypePublic NotInheritable Class StorageItemThumbnail
Implements IDisposable, IRandomAccessStreamWithContentType- Herança
- 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. |