StorageFolder.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, UInt32, ThumbnailOptions) |
Obtém uma imagem em miniatura para a pasta atual, dimensionada para a finalidade especificada da miniatura e ajustada para o tamanho solicitado com as opções especificadas. |
| GetThumbnailAsync(ThumbnailMode, UInt32) |
Obtém uma imagem em miniatura para a pasta atual, dimensionada para a finalidade especificada da miniatura e ajustada para o tamanho solicitado. |
| GetThumbnailAsync(ThumbnailMode) |
Obtém uma imagem em miniatura para a pasta atual, dimensionada para a finalidade especificada da miniatura. |
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
Obtém uma imagem em miniatura para a pasta atual, dimensionada para a finalidade especificada da miniatura e ajustada para o tamanho solicitado com as 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
Um valor da 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. Esse método usa requestedSize como guia e tenta dimensionar a imagem em miniatura sem reduzir a qualidade da imagem.
Se esse método não conseguir encontrar uma imagem em miniatura que possa ser dimensionada para o tamanho solicitado, ele poderá retornar uma miniatura maior. Se nenhuma miniatura maior estiver disponível, ela poderá retornar uma imagem em miniatura menor que o tamanho solicitado.
- options
- ThumbnailOptions
Um valor da enumeração que especifica como recuperar e dimensionar a imagem. O valor padrão, UseCurrentScale, é adequado para a maioria dos aplicativos.
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 à pasta.
Implementações
- Atributos
Confira também
Aplica-se a
GetThumbnailAsync(ThumbnailMode, UInt32)
Obtém uma imagem em miniatura para a pasta atual, dimensionada para a finalidade especificada da miniatura e ajustada para o 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
Um valor da 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. Esse método usa requestedSize como guia e tenta dimensionar a imagem em miniatura sem reduzir a qualidade da imagem.
Se esse método não conseguir encontrar uma imagem em miniatura que possa ser dimensionada para o tamanho solicitado, ele poderá retornar uma miniatura maior. Se nenhuma miniatura maior estiver disponível, ela poderá retornar uma imagem em miniatura menor que o tamanho solicitado.
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 à pasta.
Implementações
- Atributos
Confira também
Aplica-se a
GetThumbnailAsync(ThumbnailMode)
Obtém uma imagem em miniatura para a pasta atual, dimensionada para a finalidade especificada 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
Um valor da 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 à pasta.
Implementações
- Atributos
Exemplos
O exemplo a seguir obtém uma imagem em miniatura para a pasta Imagens do usuário e exibe a miniatura em um controle Image . Este exemplo também solicita uma imagem cujo lado mais longo é de 64 pixels e solicita a imagem somente se ela já estiver armazenada em cache no dispositivo. O exemplo pressupõe que haja um controle Image chamado ImageControl na página atual.
Antes de executar o exemplo a seguir, habilite a funcionalidade Biblioteca de Imagens no arquivo de manifesto do aplicativo.
using Windows.Storage;
using Windows.Storage.FileProperties;
using System.Threading.Tasks;
using Windows.UI.Xaml.Media.Imaging; // For the Bitmap object.
// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;
// Get a thumbnail for the current folder.
StorageItemThumbnail thumb =
await picturesFolder.GetThumbnailAsync(ThumbnailMode.SingleItem,
64, ThumbnailOptions.ReturnOnlyIfCached);
// Display the thumbnail in an Image control
// named ImageControl on the current page.
BitmapImage bitmapImage = new BitmapImage();
bitmapImage.SetSource(thumb);
ImageControl.Source = bitmapImage;
Comentários
Para obter um exemplo que demonstra o método GetThumbnailAsync , consulte Exemplo de miniatura de arquivo e pasta.
Para obter diretrizes sobre como escolher o melhor modo de miniatura, consulte Diretrizes e lista de verificação para miniaturas.
O método StorageFolder.GetThumbnailAsync às vezes retorna a imagem padrão de uma pasta. Para Windows Phone aplicativo 8.x, esse método ignora o tema atual quando retorna essa imagem padrão. A imagem retornada é sempre a imagem do tema escuro; ou seja, a pasta é transparente com uma borda branca. Se você quiser retornar a imagem para o tema claro, precisará criar sua própria imagem visível em um plano de fundo claro. Em seguida, você precisa usar a lógica condicional para marcar o tema ativo. Se o tema ativo for o tema claro, use um método diferente de GetThumbnailAsync para recuperar sua imagem personalizada.