Share via

StorageFile.GetThumbnailAsync Método

  • Referência

Definição

Namespace:
Windows.Storage

Sobrecargas

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Recupera uma imagem em miniatura ajustada para o arquivo, determinada pela finalidade da miniatura, pelo tamanho solicitado e pelas opções especificadas.
GetThumbnailAsync(ThumbnailMode)

Recupera uma imagem em miniatura ajustada para o arquivo, determinada pela finalidade da miniatura.
GetThumbnailAsync(ThumbnailMode, UInt32)

Recupera uma imagem em miniatura ajustada para o arquivo, determinada pela finalidade da miniatura e pelo tamanho solicitado.

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Editar

Recupera uma imagem em miniatura ajustada para o arquivo, determinada pela finalidade da miniatura, pelo tamanho solicitado e pelas opções especificadas.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options) = GetThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize, ThumbnailOptions const& options);
[Windows.Foundation.Metadata.Overload("GetThumbnailAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode, uint requestedSize, ThumbnailOptions options);
function getThumbnailAsync(mode, requestedSize, options)
Public Function GetThumbnailAsync (mode As ThumbnailMode, requestedSize As UInteger, options As ThumbnailOptions) As IAsyncOperation(Of StorageItemThumbnail)

Parâmetros

mode
ThumbnailMode

O valor de enumeração que descreve a finalidade da miniatura e determina como a imagem em miniatura é ajustada.

Para obter diretrizes sobre como escolher o melhor modo de miniatura, consulte Diretrizes e lista de verificação para miniaturas.

requestedSize
UInt32

unsigned int

uint32_t

O tamanho solicitado, em pixels, da borda mais longa da miniatura. O Windows usa requestedSize como guia e tenta dimensionar a imagem em miniatura sem reduzir a qualidade da imagem.

Se o Windows não conseguir encontrar uma imagem em miniatura que possa ser dimensionada para atender ao tamanho solicitado, uma miniatura maior poderá ser retornada. Se nenhuma miniatura maior estiver disponível, uma imagem em miniatura menor que o tamanho solicitado poderá ser retornada.

options
ThumbnailOptions

O valor de enumeração que descreve o comportamento desejado a ser usado para recuperar a imagem em miniatura. O comportamento especificado pode afetar o tamanho e/ou a qualidade da imagem e a rapidez com que a imagem em miniatura é recuperada.

Retornos

IAsyncOperation<StorageItemThumbnail>

Quando esse método for concluído com êxito, ele retornará um StorageItemThumbnail que representa a imagem em miniatura ou nulo se não houver nenhuma imagem em miniatura associada ao arquivo.

Implementações

M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t,Windows.Storage.FileProperties.ThumbnailOptions)
Atributos
OverloadAttribute RemoteAsyncAttribute

Exemplos

Este exemplo mostra como capturar a miniatura de um arquivo usando o método [storageFile.getThumbnailAsync(mode, requestedSize, options).

storageFile.getThumbnailAsync(
    Windows.Storage.FileProperties.ThumbnailMode.musicView,
    100,
    Windows.Storage.FileProperties.ThumbnailOptions.useCurrentScale).then(
        function (storageItemThumbnail) {
            // Add code to process thumbnail
        }
    );

Você deve ter um objeto StorageFile (storageFile no exemplo) que representa seu arquivo para usar um dos métodos StorageFile.GetThumbnailAsync .

Comentários

Embora GetThumbnailAsync adere ao tamanho máximo compatível com o cache de disco de miniatura, GetScaledImageAsThumbnailAsync pode extrair miniaturas maiores do que o que o cache de disco de miniatura dá suporte. GetScaledImageAsThumbnailAsync fornece a qualidade ideal, mas pode afetar o desempenho por não usar o cache de disco se o tamanho da miniatura for muito grande.

Confira também

Aplica-se a

GetThumbnailAsync(ThumbnailMode)

Editar

Recupera uma imagem em miniatura ajustada para o arquivo, determinada pela finalidade da miniatura.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode) = GetThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode);
[Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode);
function getThumbnailAsync(mode)
Public Function GetThumbnailAsync (mode As ThumbnailMode) As IAsyncOperation(Of StorageItemThumbnail)

Parâmetros

mode
ThumbnailMode

O valor de enumeração que descreve a finalidade da miniatura e determina como a imagem em miniatura é ajustada.

Para obter diretrizes sobre como escolher o melhor modo de miniatura, consulte Diretrizes e lista de verificação para miniaturas.

Retornos

IAsyncOperation<StorageItemThumbnail>

Quando esse método for concluído com êxito, ele retornará um StorageItemThumbnail que representa a imagem em miniatura ou nulo se não houver nenhuma imagem em miniatura associada ao arquivo.

Implementações

GetThumbnailAsync(ThumbnailMode)
Atributos
OverloadAttribute RemoteAsyncAttribute

Comentários

Embora GetThumbnailAsync adere ao tamanho máximo compatível com o cache de disco de miniatura, GetScaledImageAsThumbnailAsync pode extrair miniaturas maiores do que o que o cache de disco de miniatura dá suporte. GetScaledImageAsThumbnailAsync fornece a qualidade ideal, mas pode afetar o desempenho por não usar o cache de disco se o tamanho da miniatura for muito grande.

Confira também

Aplica-se a

GetThumbnailAsync(ThumbnailMode, UInt32)

Editar

Recupera uma imagem em miniatura ajustada para o arquivo, determinada pela finalidade da miniatura e pelo tamanho solicitado.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize) = GetThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize);
[Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode, uint requestedSize);
function getThumbnailAsync(mode, requestedSize)
Public Function GetThumbnailAsync (mode As ThumbnailMode, requestedSize As UInteger) As IAsyncOperation(Of StorageItemThumbnail)

Parâmetros

mode
ThumbnailMode

O valor de enumeração que descreve a finalidade da miniatura e determina como a imagem em miniatura é ajustada.

Para obter diretrizes sobre como escolher o melhor modo de miniatura, consulte Diretrizes e lista de verificação para miniaturas.

requestedSize
UInt32

unsigned int

uint32_t

O tamanho solicitado, em pixels, da borda mais longa da miniatura. O Windows usa requestedSize como guia e tenta dimensionar a imagem em miniatura sem reduzir a qualidade da imagem.

Se o Windows não conseguir encontrar uma imagem em miniatura que possa ser dimensionada para atender ao tamanho solicitado, uma miniatura maior poderá ser retornada. Se nenhuma miniatura maior estiver disponível, uma imagem em miniatura menor que o tamanho solicitado poderá ser retornada.

Retornos

IAsyncOperation<StorageItemThumbnail>

Quando esse método for concluído com êxito, ele retornará um StorageItemThumbnail que representa a imagem em miniatura ou nulo se não houver nenhuma imagem em miniatura associada ao arquivo.

Implementações

M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t)
Atributos
OverloadAttribute RemoteAsyncAttribute

Comentários

Embora GetThumbnailAsync adere ao tamanho máximo compatível com o cache de disco de miniatura, GetScaledImageAsThumbnailAsync pode extrair miniaturas maiores do que o que o cache de disco de miniatura dá suporte. GetScaledImageAsThumbnailAsync fornece a qualidade ideal, mas pode afetar o desempenho por não usar o cache de disco se o tamanho da miniatura for muito grande.

Confira também

Aplica-se a