Partilhar via


StorageFolder.GetThumbnailAsync Método

Definição

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

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

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

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

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.

Confira também

Aplica-se a