Freigeben über


StorageItemThumbnail Klasse

Definition

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
Implementiert

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.

Gilt für:

Weitere Informationen