Freigeben über


StorageFile.GetThumbnailAsync Methode

Definition

Überlädt

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Ruft ein angepasstes Miniaturbild für die Datei ab, das durch den Zweck der Miniaturansicht, die angeforderte Größe und die angegebenen Optionen bestimmt wird.

GetThumbnailAsync(ThumbnailMode)

Ruft ein angepasstes Miniaturbild für die Datei ab, das vom Zweck der Miniaturansicht bestimmt wird.

GetThumbnailAsync(ThumbnailMode, UInt32)

Ruft ein angepasstes Miniaturbild für die Datei ab, das vom Zweck der Miniaturansicht und der angeforderten Größe bestimmt wird.

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Ruft ein angepasstes Miniaturbild für die Datei ab, das durch den Zweck der Miniaturansicht, die angeforderte Größe und die angegebenen Optionen bestimmt wird.

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)

Parameter

mode
ThumbnailMode

Der Enumerationswert, der den Zweck der Miniaturansicht beschreibt und bestimmt, wie das Miniaturbild angepasst wird.

Eine Anleitung zum Auswählen des besten Miniaturansichtmodus finden Sie unter Richtlinien und Prüfliste für Miniaturansichten.

requestedSize
UInt32

unsigned int

uint32_t

Die angeforderte Größe des längsten Rands der Miniaturansicht in Pixel. Windows verwendet requestedSize als Leitfaden und versucht, das Miniaturbild zu skalieren, ohne die Qualität des Bilds zu verringern.

Wenn Windows ein Miniaturbild nicht finden kann, das skaliert werden kann, um die angeforderte Größe zu erfüllen, wird möglicherweise eine größere Miniaturansicht zurückgegeben. Wenn keine größere Miniaturansicht verfügbar ist, wird möglicherweise ein Miniaturbild zurückgegeben, das kleiner als die angeforderte Größe ist.

options
ThumbnailOptions

Der Enumerationswert, der das gewünschte Verhalten beschreibt, das zum Abrufen des Miniaturbilds verwendet werden soll. Das angegebene Verhalten kann sich auf die Größe und/oder Qualität des Bilds und die Art und Weise auswirken, wie schnell das Miniaturbild abgerufen wird.

Gibt zurück

Wenn diese Methode erfolgreich abgeschlossen wurde, wird ein StorageItemThumbnail zurückgegeben, das das Miniaturbild darstellt, oder NULL , wenn der Datei kein Miniaturbild zugeordnet ist.

Implementiert

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

Beispiele

In diesem Beispiel wird gezeigt, wie Sie die Miniaturansicht einer Datei mithilfe der [storageFile.getThumbnailAsync(mode, requestedSize, options)-Methode erfassen.

storageFile.getThumbnailAsync(
    Windows.Storage.FileProperties.ThumbnailMode.musicView,
    100,
    Windows.Storage.FileProperties.ThumbnailOptions.useCurrentScale).then(
        function (storageItemThumbnail) {
            // Add code to process thumbnail
        }
    );

Sie benötigen ein StorageFile-Objekt (storageFile im Beispiel), das Ihre Datei darstellt, um eine der StorageFile.GetThumbnailAsync-Methoden verwenden zu können.

Hinweise

Während GetThumbnailAsync die maximale Größe einhält, die vom Datenträgercache für Miniaturansichten unterstützt wird, kann GetScaledImageAsThumbnailAsync Miniaturansichten extrahieren, die größer sind als die vom Miniaturansichten-Datenträgercache unterstützten Werte. GetScaledImageAsThumbnailAsync bietet eine optimale Qualität, kann sich jedoch auf die Leistung auswirken, indem der Datenträgercache nicht verwendet wird, wenn die Miniaturansicht zu groß ist.

Weitere Informationen

Gilt für:

GetThumbnailAsync(ThumbnailMode)

Ruft ein angepasstes Miniaturbild für die Datei ab, das vom Zweck der Miniaturansicht bestimmt wird.

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)

Parameter

mode
ThumbnailMode

Der Enumerationswert, der den Zweck der Miniaturansicht beschreibt und bestimmt, wie das Miniaturbild angepasst wird.

Eine Anleitung zum Auswählen des besten Miniaturansichtmodus finden Sie unter Richtlinien und Prüfliste für Miniaturansichten.

Gibt zurück

Wenn diese Methode erfolgreich abgeschlossen wurde, wird ein StorageItemThumbnail zurückgegeben, das das Miniaturbild darstellt, oder NULL , wenn der Datei kein Miniaturbild zugeordnet ist.

Implementiert

Attribute

Hinweise

Während GetThumbnailAsync die maximale Größe einhält, die vom Datenträgercache für Miniaturansichten unterstützt wird, kann GetScaledImageAsThumbnailAsync Miniaturansichten extrahieren, die größer sind als die vom Miniaturansichten-Datenträgercache unterstützten Werte. GetScaledImageAsThumbnailAsync bietet eine optimale Qualität, kann sich jedoch auf die Leistung auswirken, indem der Datenträgercache nicht verwendet wird, wenn die Miniaturansicht zu groß ist.

Weitere Informationen

Gilt für:

GetThumbnailAsync(ThumbnailMode, UInt32)

Ruft ein angepasstes Miniaturbild für die Datei ab, das vom Zweck der Miniaturansicht und der angeforderten Größe bestimmt wird.

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)

Parameter

mode
ThumbnailMode

Der Enumerationswert, der den Zweck der Miniaturansicht beschreibt und bestimmt, wie das Miniaturbild angepasst wird.

Eine Anleitung zum Auswählen des besten Miniaturansichtmodus finden Sie unter Richtlinien und Prüfliste für Miniaturansichten.

requestedSize
UInt32

unsigned int

uint32_t

Die angeforderte Größe des längsten Rands der Miniaturansicht in Pixel. Windows verwendet requestedSize als Leitfaden und versucht, das Miniaturbild zu skalieren, ohne die Qualität des Bilds zu verringern.

Wenn Windows ein Miniaturbild nicht finden kann, das skaliert werden kann, um die angeforderte Größe zu erfüllen, wird möglicherweise eine größere Miniaturansicht zurückgegeben. Wenn keine größere Miniaturansicht verfügbar ist, wird möglicherweise ein Miniaturbild zurückgegeben, das kleiner als die angeforderte Größe ist.

Gibt zurück

Wenn diese Methode erfolgreich abgeschlossen wurde, wird ein StorageItemThumbnail zurückgegeben, das das Miniaturbild darstellt, oder NULL , wenn der Datei kein Miniaturbild zugeordnet ist.

Implementiert

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

Hinweise

Während GetThumbnailAsync die maximale Größe einhält, die vom Datenträgercache für Miniaturansichten unterstützt wird, kann GetScaledImageAsThumbnailAsync Miniaturansichten extrahieren, die größer sind als die vom Miniaturansichten-Datenträgercache unterstützten Werte. GetScaledImageAsThumbnailAsync bietet eine optimale Qualität, kann sich jedoch auf die Leistung auswirken, indem der Datenträgercache nicht verwendet wird, wenn die Miniaturansicht zu groß ist.

Weitere Informationen

Gilt für: