IStorageItemProperties.GetThumbnailAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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