StorageItemThumbnail Klasse

Definition

Namespace:

Windows.Storage.FileProperties

Stellt das Miniaturbild dar, das einer Systemressource (z. B. einer Datei oder einem Ordner) zugeordnet ist.

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

Vererbung

Object Platform::Object IInspectable StorageItemThumbnail

Attribute

ContractVersionAttribute

Implementiert

IClosable IDisposable IContentTypeProvider IInputStream IOutputStream IRandomAccessStream IRandomAccessStreamWithContentType

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

In diesem Beispiel wird veranschaulicht, wie Miniaturansichten für Dateien abgerufen werden.

// 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);
}

Nachdem GetThumbnailAsync abgeschlossen ist, ruft die Miniaturansicht ein StorageItemThumbnail-Objekt ab.

Im Beispiel ruft die file Variable eine StorageFile-Datei ab, die jede Datei darstellt, für die wir eine Miniaturansicht abrufen möchten. Wir haben eine Abfrage verwendet, um StorageFile-Objekte für diese Dateien abzurufen (die in der file Variablen gespeichert sind). Sie können jedoch den für Ihre App am besten geeigneten Ansatz verwenden, um StorageFile-Objekte abzurufen (z. B. über die Dateiauswahl).

Hinweise

Sie können Miniaturansichten für viele Dateisystemressourcen über die Windows-Runtime-Objekte abrufen, die sie darstellen. Viele dieser Objekte verfügen über Methoden oder Eigenschaften, mit denen Sie ein StorageItemThumbnail abrufen (und manchmal festlegen) können, das die Miniaturansicht darstellt, die einer bestimmten Ressource zugeordnet ist.

Informationen zum Abrufen einer Miniaturansicht für ein bestimmtes Windows-Runtime-Objekt finden Sie in der Dokumentation zu diesem Objekt. Wenn Sie beispielsweise eine Miniaturansicht für eine Datei abrufen möchten, können Sie eine der Methoden StorageFile.getThumbnailAsync aufrufen, oder um eine Miniaturansicht für einen Kontakt zu erhalten, können Sie die Contact.thumbnail-Eigenschaft verwenden.

Weitere Codebeispiele zum Abrufen von Miniaturansichten finden Sie im Beispiel zur Ordneraufzählung und im Beispiel Dateiminiaturansichten.

Eigenschaften

CanRead	Ruft einen Wert ab, der angibt, ob der Miniaturansichtsdatenstrom gelesen werden kann.
CanWrite	Ruft einen Wert ab, der angibt, ob der Miniaturansichtsdatenstrom geschrieben werden kann.
ContentType	Ruft den MIME-Inhaltstyp des Miniaturbilds ab.
OriginalHeight	Ruft die ursprüngliche (nicht skalierte) Höhe des Miniaturbilds ab.
OriginalWidth	Ruft die ursprüngliche (nicht skalierte) Breite des Miniaturbilds ab.
Position	Ruft den Byteoffset des Miniaturansichtsdatenstroms ab.
ReturnedSmallerCachedSize	Ruft einen Wert ab, der angibt, ob es sich bei dem zurückgegebenen Miniaturbild um eine zwischengespeicherte Version mit einer kleineren Größe handelt.
Size	Ruft die Größe des Miniaturbilds ab oder legt sie fest.
Type	Ruft einen Wert ab, der angibt, ob es sich bei der Miniaturansicht um ein Symbol oder ein Bild handelt.

Methoden

CloneStream()	Erstellt einen neuen Stream über der Miniaturansicht, die durch das aktuelle storageItemThumbnail-Objekt dargestellt wird.
Close()	Gibt Systemressourcen frei, die von einem Windows-Runtime-Objekt verfügbar gemacht werden.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
FlushAsync()	Löscht Daten asynchron in einem sequenziellen Stream.
GetInputStreamAt(UInt64)	Ruft die Miniaturbilddaten als nicht codierten Stream ab.
GetOutputStreamAt(UInt64)	Ruft ein Ausgabestreamobjekt zum Schreiben von Miniaturbilddaten in ein Speicherelement ab.
ReadAsync(IBuffer, UInt32, InputStreamOptions)	Gibt ein asynchrones Byteleseobjekt zurück.
Seek(UInt64)	Legt den Offset des Miniaturansichtsdatenstroms auf den angegebenen Wert fest.
WriteAsync(IBuffer)	Schreibt Daten asynchron in einen sequenziellen Stream.

Weitere Informationen

• StorageFile
• Beispiel für Datei- und Ordnerminiaturansichten (Windows 10)