Partilhar via


IStorageItemProperties.GetThumbnailAsync Método

Definição

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

Confira também

Aplica-se a