IStorageItemProperties.GetThumbnailAsync 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
| GetThumbnailAsync(ThumbnailMode) |
Recupera uma imagem em miniatura ajustada para o item, determinada pela finalidade da miniatura. |
| GetThumbnailAsync(ThumbnailMode, UInt32) |
Recupera uma imagem de miniatura ajustada para o item, determinada pela finalidade da miniatura e pelo tamanho solicitado. |
| GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
Recupera uma imagem de miniatura ajustada para o item, determinada pela finalidade da miniatura, pelo tamanho solicitado e pelas opções especificadas. |
GetThumbnailAsync(ThumbnailMode)
Recupera uma imagem em miniatura ajustada para o item, determinada pela finalidade da miniatura.
public:
IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode);/// [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.
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.
- Atributos
Comentários
No Windows 8, o método GetThumbnailAsync tem apenas um monitor imersivo por vez que pode mostrar a interface do usuário do aplicativo UWP. Em Windows 8.1, a interface do usuário do aplicativo UWP pode aparecer em vários monitores, com a opção de mostrar um único aplicativo em vários monitores simultaneamente. Para dimensionar, considere vários fatores de escala ao mesmo tempo.
Em Windows 8.1, o método GetThumbnailAsync pode retornar qualquer miniatura de tamanho. Portanto, os aplicativos que exibem imagens locais devem chamar esse método para obter a imagem dimensionada que desejam exibir. Isso garante que os aplicativos se beneficiem de todas as otimizações de cache e desempenho, incluindo um mecanismo especial para obter miniaturas da nuvem sem baixar o arquivo completo.
Confira também
Aplica-se a
GetThumbnailAsync(ThumbnailMode, UInt32)
Recupera uma imagem de miniatura ajustada para o item, determinada pela finalidade da miniatura e pelo tamanho solicitado.
public:
IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize);/// [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.
- requestedSize
-
UInt32
unsigned int
uint32_t
O tamanho solicitado, em pixels, da borda mais longa da miniatura. O Windows usa o requestedSize como um guia e tenta dimensionar a imagem em miniatura sem reduzir a qualidade da imagem.
Se o Windows não 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.
- Atributos
Confira também
Aplica-se a
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
Recupera uma imagem de miniatura ajustada para o item, determinada pela finalidade da miniatura, pelo tamanho solicitado e pelas opções especificadas.
public:
IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options);/// [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.
- requestedSize
-
UInt32
unsigned int
uint32_t
O tamanho solicitado, em pixels, da borda mais longa da miniatura. O Windows usa o requestedSize como um guia e tenta dimensionar a imagem em miniatura sem reduzir a qualidade da imagem.
Se o Windows não 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.
- Atributos