StorageItemThumbnail Classe

Définition

Espace de noms:

Windows.Storage.FileProperties

Représente l’image miniature associée à une ressource système (comme un fichier ou un dossier).

public ref class StorageItemThumbnail sealed : IClosable, IRandomAccessStreamWithContentType

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemThumbnail final : IClosable, IRandomAccessStreamWithContentType

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemThumbnail : System.IDisposable, IRandomAccessStreamWithContentType

Public NotInheritable Class StorageItemThumbnail
Implements IDisposable, IRandomAccessStreamWithContentType

Héritage

Object Platform::Object IInspectable StorageItemThumbnail

Attributs

ContractVersionAttribute

Implémente

IClosable IDisposable IContentTypeProvider IInputStream IOutputStream IRandomAccessStream IRandomAccessStreamWithContentType

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple montre comment obtenir des miniatures pour les fichiers.

// Set query options with filter and sort order for results
List<string> fileTypeFilter = new List<string>();
fileTypeFilter.Add(".jpg");
fileTypeFilter.Add(".png");
fileTypeFilter.Add(".bmp");
fileTypeFilter.Add(".gif");
var queryOptions = new QueryOptions(CommonFileQuery.OrderByName, fileTypeFilter);

// Create query and retrieve files.
var query = KnownFolders.PicturesLibrary.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList<StorageFile> fileList = await query.GetFilesAsync();
// Process results
foreach (StorageFile file in fileList)
{
    // Get thumbnail
    const uint requestedSize = 190;
    const ThumbnailMode thumbnailMode = ThumbnailMode.PicturesView;
    const ThumbnailOptions thumbnailOptions = ThumbnailOptions.UseCurrentScale;
    var thumbnail = await file.GetThumbnailAsync(thumbnailMode, requestedSize, thumbnailOptions);
}

Une fois GetThumbnailAsync terminé, la miniature obtient un objet StorageItemThumbnail.

Dans l’exemple, la file variable obtient un StorageFile qui représente chaque fichier pour lequel nous voulons récupérer une miniature. Nous avons utilisé une requête pour obtenir des objets StorageFile pour ces fichiers (stockés dans la file variable), mais vous pouvez utiliser l’approche la mieux adaptée à votre application pour obtenir des objets StorageFile (par exemple, via le sélecteur de fichiers).

Remarques

Vous pouvez obtenir des miniatures pour de nombreuses ressources de système de fichiers via les objets Windows Runtime qui les représentent. La plupart de ces objets ont des méthodes ou des propriétés qui vous permettent d’obtenir (et parfois de définir) un Objet StorageItemThumbnail qui représente la miniature associée à une ressource particulière.

Pour savoir comment obtenir la miniature d’un objet Windows Runtime particulier, consultez la documentation relative à cet objet. Par exemple, pour obtenir une miniature d’un fichier, vous pouvez appeler l’une des méthodes StorageFile.getThumbnailAsync , ou pour obtenir une miniature pour un contact, vous pouvez utiliser la propriété Contact.thumbnail .

Pour plus d’exemples de code sur la récupération des miniatures, consultez l’exemple d’énumération de dossiers et l’exemple Miniatures de fichier.

Propriétés

CanRead	Obtient une valeur qui indique si le flux de miniatures peut être lu.
CanWrite	Obtient une valeur qui indique si le flux de miniatures peut être écrit dans.
ContentType	Obtient le type de contenu MIME de l’image miniature.
OriginalHeight	Obtient la hauteur d’origine (non mise à l’échelle) de l’image miniature.
OriginalWidth	Obtient la largeur d’origine (non mise à l’échelle) de l’image miniature.
Position	Obtient le décalage d’octet du flux de miniatures.
ReturnedSmallerCachedSize	Obtient une valeur qui indique si l’image miniature retournée était une version mise en cache avec une taille plus petite.
Size	Obtient ou définit la taille de l’image miniature.
Type	Obtient une valeur qui indique si la miniature est une icône ou une image.

Méthodes

CloneStream()	Crée un flux sur la miniature représentée par l’objet storageItemThumbnail actuel.
Close()	Libère les ressources système exposées par un objet Windows Runtime.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
FlushAsync()	Vide les données de manière asynchrone dans un flux séquentiel.
GetInputStreamAt(UInt64)	Récupère les données d’image miniature en tant que flux non décodé.
GetOutputStreamAt(UInt64)	Récupère un objet de flux de sortie pour écrire des données d’image miniature dans un élément de stockage.
ReadAsync(IBuffer, UInt32, InputStreamOptions)	Retourne un objet de lecteur d’octets asynchrone.
Seek(UInt64)	Définit le décalage du flux de miniatures sur la valeur spécifiée.
WriteAsync(IBuffer)	Écrit des données de manière asynchrone dans un flux séquentiel.

Voir aussi

• StorageFile
• Exemple de miniatures de fichiers et de dossiers (Windows 10)