Partilhar via


StorageFile.GetScaledImageAsThumbnailAsync Método

Definição

Sobrecargas

GetScaledImageAsThumbnailAsync(ThumbnailMode)

Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura.

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura e pelo tamanho solicitado.

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura, pelo tamanho solicitado e pelas opções especificadas

GetScaledImageAsThumbnailAsync(ThumbnailMode)

Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode);
function getScaledImageAsThumbnailAsync(mode)
Public Function GetScaledImageAsThumbnailAsync (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

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 item.

Implementações

Atributos

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

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura e pelo tamanho solicitado.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode, uint requestedSize);
function getScaledImageAsThumbnailAsync(mode, requestedSize)
Public Function GetScaledImageAsThumbnailAsync (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

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 item.

Implementações

M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t)
Atributos

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

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura, pelo tamanho solicitado e pelas opções especificadas

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize, ThumbnailOptions const& options);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode, uint requestedSize, ThumbnailOptions options);
function getScaledImageAsThumbnailAsync(mode, requestedSize, options)
Public Function GetScaledImageAsThumbnailAsync (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

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 item.

Implementações

M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t,Windows.Storage.FileProperties.ThumbnailOptions)
Atributos

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