StorageFolder.GetThumbnailAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
Obtient une image miniature pour le dossier actif, dimensionnée pour l’objectif spécifié de la miniature et ajustée à la taille demandée avec les options spécifiées. |
| GetThumbnailAsync(ThumbnailMode, UInt32) |
Obtient une image miniature pour le dossier actif, dimensionnée pour l’objectif spécifié de la miniature et ajustée à la taille demandée. |
| GetThumbnailAsync(ThumbnailMode) |
Obtient une image miniature pour le dossier actif, dimensionnée pour l’objectif spécifié de la miniature. |
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
Obtient une image miniature pour le dossier actif, dimensionnée pour l’objectif spécifié de la miniature et ajustée à la taille demandée avec 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 de l’énumération 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. Cette méthode utilise requestedSize comme guide et tente de mettre à l’échelle l’image miniature sans réduire la qualité de l’image.
Si cette méthode ne parvient pas à trouver une image miniature qu’elle peut mettre à l’échelle à la taille demandée, elle peut retourner une miniature plus grande. Si aucune miniature plus grande n’est disponible, elle peut renvoyer une image miniature inférieure à la taille demandée.
- options
- ThumbnailOptions
Valeur de l’énumération qui spécifie comment récupérer et dimensionner l’image. La valeur par défaut, UseCurrentScale, convient à la plupart des applications.
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 dossier.
Implémente
- Attributs
Voir aussi
S’applique à
GetThumbnailAsync(ThumbnailMode, UInt32)
Obtient une image miniature pour le dossier actif, dimensionnée pour l’objectif spécifié de la miniature et ajustée à 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 de l’énumération 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. Cette méthode utilise requestedSize comme guide et tente de mettre à l’échelle l’image miniature sans réduire la qualité de l’image.
Si cette méthode ne parvient pas à trouver une image miniature qu’elle peut mettre à l’échelle à la taille demandée, elle peut retourner une miniature plus grande. Si aucune miniature plus grande n’est disponible, elle peut renvoyer une image miniature inférieure à la taille demandé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 dossier.
Implémente
- Attributs
Voir aussi
S’applique à
GetThumbnailAsync(ThumbnailMode)
Obtient une image miniature pour le dossier actif, dimensionnée pour l’objectif spécifié 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 de l’énumération 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 dossier.
Implémente
- Attributs
Exemples
L’exemple suivant obtient une image miniature pour le dossier Images de l’utilisateur et affiche la miniature dans un contrôle Image . Cet exemple demande également une image dont le côté le plus long est de 64 pixels et demande l’image uniquement si elle est déjà mise en cache sur l’appareil. L’exemple suppose qu’il existe un contrôle Image nommé ImageControl sur la page active.
Avant d’exécuter l’exemple suivant, activez la fonctionnalité Bibliothèque d’images dans le fichier manifeste de l’application.
using Windows.Storage;
using Windows.Storage.FileProperties;
using System.Threading.Tasks;
using Windows.UI.Xaml.Media.Imaging; // For the Bitmap object.
// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;
// Get a thumbnail for the current folder.
StorageItemThumbnail thumb =
await picturesFolder.GetThumbnailAsync(ThumbnailMode.SingleItem,
64, ThumbnailOptions.ReturnOnlyIfCached);
// Display the thumbnail in an Image control
// named ImageControl on the current page.
BitmapImage bitmapImage = new BitmapImage();
bitmapImage.SetSource(thumb);
ImageControl.Source = bitmapImage;
Remarques
Pour obtenir un exemple illustrant la méthode GetThumbnailAsync , consultez Exemple de miniature de fichier et de dossier.
Pour obtenir des conseils sur le choix du meilleur mode miniature, consultez Recommandations et liste de contrôle pour les miniatures.
La méthode StorageFolder.GetThumbnailAsync retourne parfois l’image par défaut d’un dossier. Pour Windows Phone’application 8.x, cette méthode ignore le thème actuel lorsqu’elle retourne cette image par défaut. L’image retournée est toujours l’image du thème sombre ; Autrement dit, le dossier est transparent avec une bordure blanche. Si vous souhaitez retourner l’image pour le thème clair, vous devez créer votre propre image qui est visible sur un arrière-plan clair. Vous devez ensuite utiliser la logique conditionnelle pour case activée le thème actif. Si le thème actif est le thème clair, utilisez une méthode autre que GetThumbnailAsync pour récupérer votre image personnalisée.