Partage via


StorageFile.GetThumbnailAsync Méthode

Définition

Surcharges

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Récupère une image miniature ajustée pour le fichier, déterminée par l’objectif de la miniature, la taille demandée et les options spécifiées.

GetThumbnailAsync(ThumbnailMode)

Récupère une image miniature ajustée pour le fichier, déterminée par l’objectif de la miniature.

GetThumbnailAsync(ThumbnailMode, UInt32)

Récupère une image miniature ajustée pour le fichier, déterminée par l’objectif de la miniature et la taille demandée.

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Récupère une image miniature ajustée pour le fichier, déterminée par l’objectif de la miniature, la taille demandée et les options spécifiées.

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)

Paramètres

mode
ThumbnailMode

Valeur enum qui décrit l’objectif de la miniature et détermine comment l’image miniature est ajustée.

Pour obtenir des conseils sur le choix du meilleur mode miniature, consultez Recommandations et liste de contrôle pour les miniatures.

requestedSize
UInt32

unsigned int

uint32_t

Taille demandée, en pixels, du bord le plus long de la miniature. Windows utilise requestedSize comme guide et tente de mettre à l’échelle l’image miniature sans réduire la qualité de l’image.

Si Windows ne parvient pas à trouver une image miniature qu’il peut mettre à l’échelle pour répondre à la taille demandée, une miniature plus grande peut être retournée. Si aucune miniature plus grande n’est disponible, une image miniature inférieure à la taille demandée peut être retournée.

options
ThumbnailOptions

Valeur enum qui décrit le comportement souhaité à utiliser pour récupérer l’image miniature. Le comportement spécifié peut affecter la taille et/ou la qualité de l’image et la rapidité de récupération de l’image miniature.

Retours

Lorsque cette méthode se termine correctement, elle renvoie un Objet StorageItemThumbnail qui représente l’image miniature ou null si aucune image miniature n’est associée au fichier.

Implémente

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)
Attributs

Exemples

Cet exemple montre comment capturer la miniature d’un fichier à l’aide de la méthode [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
        }
    );

Vous devez disposer d’un objet StorageFile (storageFile dans l’exemple) qui représente votre fichier pour pouvoir utiliser l’une des méthodes StorageFile.GetThumbnailAsync .

Remarques

Alors que GetThumbnailAsync respecte la taille maximale prise en charge par le cache de disque miniature, GetScaledImageAsThumbnailAsync peut extraire des miniatures supérieures à ce que le cache de disque de miniatures prend en charge. GetScaledImageAsThumbnailAsync fournit une qualité optimale, mais peut affecter les performances en n’utilisant pas le cache de disque si la taille de la miniature est trop grande.

Voir aussi

S’applique à

GetThumbnailAsync(ThumbnailMode)

Récupère une image miniature ajustée pour le fichier, déterminée par l’objectif de la miniature.

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)

Paramètres

mode
ThumbnailMode

Valeur enum qui décrit l’objectif de la miniature et détermine comment l’image miniature est ajustée.

Pour obtenir des conseils sur le choix du meilleur mode miniature, consultez Recommandations et liste de contrôle pour les miniatures.

Retours

Lorsque cette méthode se termine correctement, elle renvoie un Objet StorageItemThumbnail qui représente l’image miniature ou null si aucune image miniature n’est associée au fichier.

Implémente

Attributs

Remarques

Alors que GetThumbnailAsync respecte la taille maximale prise en charge par le cache de disque miniature, GetScaledImageAsThumbnailAsync peut extraire des miniatures supérieures à ce que le cache de disque de miniatures prend en charge. GetScaledImageAsThumbnailAsync fournit une qualité optimale, mais peut affecter les performances en n’utilisant pas le cache de disque si la taille de la miniature est trop grande.

Voir aussi

S’applique à

GetThumbnailAsync(ThumbnailMode, UInt32)

Récupère une image miniature ajustée pour le fichier, déterminée par l’objectif de la miniature et la taille demandée.

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)

Paramètres

mode
ThumbnailMode

Valeur enum qui décrit l’objectif de la miniature et détermine comment l’image miniature est ajustée.

Pour obtenir des conseils sur le choix du meilleur mode miniature, consultez Recommandations et liste de contrôle pour les miniatures.

requestedSize
UInt32

unsigned int

uint32_t

Taille demandée, en pixels, du bord le plus long de la miniature. Windows utilise requestedSize comme guide et tente de mettre à l’échelle l’image miniature sans réduire la qualité de l’image.

Si Windows ne parvient pas à trouver une image miniature qu’il peut mettre à l’échelle pour répondre à la taille demandée, une miniature plus grande peut être retournée. Si aucune miniature plus grande n’est disponible, une image miniature inférieure à la taille demandée peut être retournée.

Retours

Lorsque cette méthode se termine correctement, elle renvoie un Objet StorageItemThumbnail qui représente l’image miniature ou null si aucune image miniature n’est associée au fichier.

Implémente

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)
Attributs

Remarques

Alors que GetThumbnailAsync respecte la taille maximale prise en charge par le cache de disque miniature, GetScaledImageAsThumbnailAsync peut extraire des miniatures supérieures à ce que le cache de disque de miniatures prend en charge. GetScaledImageAsThumbnailAsync fournit une qualité optimale, mais peut affecter les performances en n’utilisant pas le cache de disque si la taille de la miniature est trop grande.

Voir aussi

S’applique à