Freigeben über


StorageFile.GetScaledImageAsThumbnailAsync Methode

Definition

Überlädt

GetScaledImageAsThumbnailAsync(ThumbnailMode)

Ruft ein skaliertes Bild als Miniaturansicht ab, die vom Zweck der Miniaturansicht bestimmt wird.

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

Ruft ein skaliertes Bild als Miniaturansicht ab, die vom Zweck der Miniaturansicht und der angeforderten Größe bestimmt wird.

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Ruft ein skaliertes Bild als Miniaturansicht ab, die vom Zweck der Miniaturansicht, der angeforderten Größe und den angegebenen Optionen bestimmt wird.

GetScaledImageAsThumbnailAsync(ThumbnailMode)

Ruft ein skaliertes Bild als Miniaturansicht ab, die vom Zweck der Miniaturansicht bestimmt wird.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode);
function getScaledImageAsThumbnailAsync(mode)
Public Function GetScaledImageAsThumbnailAsync (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 dem Element 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:

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

Ruft ein skaliertes Bild als Miniaturansicht ab, die vom Zweck der Miniaturansicht und der angeforderten Größe bestimmt wird.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode, uint requestedSize);
function getScaledImageAsThumbnailAsync(mode, requestedSize)
Public Function GetScaledImageAsThumbnailAsync (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 dem Element kein Miniaturbild zugeordnet ist.

Implementiert

M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(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:

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Ruft ein skaliertes Bild als Miniaturansicht ab, die vom Zweck der Miniaturansicht, der angeforderten Größe und den angegebenen Optionen bestimmt wird.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize, ThumbnailOptions const& options);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode, uint requestedSize, ThumbnailOptions options);
function getScaledImageAsThumbnailAsync(mode, requestedSize, options)
Public Function GetScaledImageAsThumbnailAsync (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 dem Element kein Miniaturbild zugeordnet ist.

Implementiert

M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t,Windows.Storage.FileProperties.ThumbnailOptions)
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: