Compartir a través de

StorageFile.GetThumbnailAsync Método

  • Referencia

Definición

Espacio de nombres:
Windows.Storage

Sobrecargas

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Recupera una imagen en miniatura ajustada para el archivo, 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 archivo, determinada por el propósito de la miniatura.
GetThumbnailAsync(ThumbnailMode, UInt32)

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

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Editar

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

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

Para obtener instrucciones sobre cómo elegir el mejor modo de miniatura, consulte Directrices y lista de comprobación para miniaturas.

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

IAsyncOperation<StorageItemThumbnail>

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 archivo.

Implementaciones

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
OverloadAttribute RemoteAsyncAttribute

Ejemplos

En este ejemplo se muestra cómo capturar la miniatura de un archivo mediante el método [storageFile.getThumbnailAsync(mode, requestedSize, options).

storageFile.getThumbnailAsync(
    Windows.Storage.FileProperties.ThumbnailMode.musicView,
    100,
    Windows.Storage.FileProperties.ThumbnailOptions.useCurrentScale).then(
        function (storageItemThumbnail) {
            // Add code to process thumbnail
        }
    );

Debe tener un objeto StorageFile (storageFile en el ejemplo) que represente el archivo para poder usar uno de los métodos StorageFile.GetThumbnailAsync .

Comentarios

Aunque GetThumbnailAsync se adhiere al tamaño máximo admitido por la memoria caché del disco en miniatura, GetScaledImageAsThumbnailAsync puede extraer miniaturas que sean mayores que las que admite la memoria caché del disco en miniatura. GetScaledImageAsThumbnailAsync proporciona una calidad óptima, pero puede afectar al rendimiento sin usar la memoria caché de disco si el tamaño de la miniatura es demasiado grande.

Consulte también

Se aplica a

GetThumbnailAsync(ThumbnailMode)

Editar

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

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

Para obtener instrucciones sobre cómo elegir el mejor modo de miniatura, consulte Directrices y lista de comprobación para miniaturas.

Devoluciones

IAsyncOperation<StorageItemThumbnail>

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 archivo.

Implementaciones

GetThumbnailAsync(ThumbnailMode)
Atributos
OverloadAttribute RemoteAsyncAttribute

Comentarios

Aunque GetThumbnailAsync se adhiere al tamaño máximo admitido por la memoria caché del disco en miniatura, GetScaledImageAsThumbnailAsync puede extraer miniaturas que sean mayores que las que admite la memoria caché del disco en miniatura. GetScaledImageAsThumbnailAsync proporciona una calidad óptima, pero puede afectar al rendimiento sin usar la memoria caché de disco si el tamaño de la miniatura es demasiado grande.

Consulte también

Se aplica a

GetThumbnailAsync(ThumbnailMode, UInt32)

Editar

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

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

Para obtener instrucciones sobre cómo elegir el mejor modo de miniatura, consulte Directrices y lista de comprobación para miniaturas.

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

IAsyncOperation<StorageItemThumbnail>

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 archivo.

Implementaciones

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
OverloadAttribute RemoteAsyncAttribute

Comentarios

Aunque GetThumbnailAsync se adhiere al tamaño máximo admitido por la memoria caché del disco en miniatura, GetScaledImageAsThumbnailAsync puede extraer miniaturas que sean mayores que las que admite la memoria caché del disco en miniatura. GetScaledImageAsThumbnailAsync proporciona una calidad óptima, pero puede afectar al rendimiento sin usar la memoria caché de disco si el tamaño de la miniatura es demasiado grande.

Consulte también

Se aplica a