IStorageItemProperties.GetThumbnailAsync Método

Definición

Sobrecargas

GetThumbnailAsync(ThumbnailMode)

Recupera una imagen en miniatura ajustada para el elemento, determinada por el propósito de la miniatura.

GetThumbnailAsync(ThumbnailMode, UInt32)

Recupera una imagen en miniatura ajustada para el elemento, determinada por el propósito de la miniatura y el tamaño solicitado.

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Recupera una imagen en miniatura ajustada para el elemento, determinada por el propósito de la miniatura, el tamaño solicitado y las opciones especificadas.

GetThumbnailAsync(ThumbnailMode)

Recupera una imagen en miniatura ajustada para el elemento, determinada por el propósito de la 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

Valor de enumeración que describe el propósito de la miniatura y determina cómo se ajusta la imagen en miniatura.

Devoluciones

Cuando este método se completa correctamente, devuelve un objeto StorageItemThumbnail que representa la imagen en miniatura o null si no hay ninguna imagen en miniatura asociada al elemento.

Atributos

Comentarios

En Windows 8, el método GetThumbnailAsync tiene solo un monitor inmersivo a la vez que puede mostrar la interfaz de usuario de la aplicación para UWP. En Windows 8.1, la interfaz de usuario de la aplicación para UWP puede aparecer en varios monitores, con la opción de mostrar una sola aplicación en varios monitores simultáneamente. Para el escalado, considere varios factores de escala a la vez.

En Windows 8.1, el método GetThumbnailAsync puede devolver cualquier miniatura de tamaño. Por lo tanto, las aplicaciones que muestran imágenes locales deben llamar a este método para obtener la imagen escalada que quieren mostrar. Esto garantiza que las aplicaciones se beneficien de todas las optimizaciones de rendimiento y caché, incluido un mecanismo especial para obtener miniaturas de la nube sin descargar el archivo completo.

Consulte también

Se aplica a

GetThumbnailAsync(ThumbnailMode, UInt32)

Recupera una imagen en miniatura ajustada para el elemento, determinada por el propósito de la miniatura y el tamaño 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

Valor de enumeración que describe el propósito de la miniatura y determina cómo se ajusta la imagen en miniatura.

requestedSize
UInt32

unsigned int

uint32_t

Tamaño solicitado, en píxeles, del borde más largo de la miniatura. Windows usa requestedSize como guía e intenta escalar la imagen en miniatura sin reducir la calidad de la imagen.

Si Windows no encuentra una imagen en miniatura que se puede escalar para satisfacer el tamaño solicitado, es posible que se devuelva una miniatura mayor. Si no hay ninguna miniatura más grande disponible, es posible que se devuelva una imagen en miniatura menor que el tamaño solicitado.

Devoluciones

Cuando este método se completa correctamente, devuelve un objeto StorageItemThumbnail que representa la imagen en miniatura o null si no hay ninguna imagen en miniatura asociada al elemento.

Atributos

Consulte también

Se aplica a

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Recupera una imagen en miniatura ajustada para el elemento, determinada por el propósito de la miniatura, el tamaño solicitado y las opciones 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

Valor de enumeración que describe el propósito de la miniatura y determina cómo se ajusta la imagen en miniatura.

requestedSize
UInt32

unsigned int

uint32_t

Tamaño solicitado, en píxeles, del borde más largo de la miniatura. Windows usa requestedSize como guía e intenta escalar la imagen en miniatura sin reducir la calidad de la imagen.

Si Windows no encuentra una imagen en miniatura que se puede escalar para satisfacer el tamaño solicitado, es posible que se devuelva una miniatura mayor. Si no hay ninguna miniatura más grande disponible, es posible que se devuelva una imagen en miniatura menor que el tamaño solicitado.

options
ThumbnailOptions

Valor de enumeración que describe el comportamiento deseado que se va a usar para recuperar la imagen en miniatura. El comportamiento especificado puede afectar al tamaño o la calidad de la imagen y la rapidez con la que se recupera la imagen en miniatura.

Devoluciones

Cuando este método se completa correctamente, devuelve un objeto StorageItemThumbnail que representa la imagen en miniatura o null si no hay ninguna imagen en miniatura asociada al elemento.

Atributos

Consulte también

Se aplica a