StorageFile.GetScaledImageAsThumbnailAsync Método
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.
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
- GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)
- GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
- GetThumbnailAsync(ThumbnailMode)
- GetThumbnailAsync(ThumbnailMode, UInt32)
- GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
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
- 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
- GetScaledImageAsThumbnailAsync(ThumbnailMode)
- GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
- GetThumbnailAsync(ThumbnailMode)
- GetThumbnailAsync(ThumbnailMode, UInt32)
- GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
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
- 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
- GetScaledImageAsThumbnailAsync(ThumbnailMode)
- GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)
- GetThumbnailAsync(ThumbnailMode)
- GetThumbnailAsync(ThumbnailMode, UInt32)
- GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)