Freigeben über


IStorageItemProperties.GetThumbnailAsync Methode

Definition

Überlädt

GetThumbnailAsync(ThumbnailMode)

Ruft ein angepasstes Miniaturbild für das Element ab, das durch den Zweck der Miniaturansicht bestimmt wird.

GetThumbnailAsync(ThumbnailMode, UInt32)

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

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Ruft ein angepasstes Miniaturbild für das Element 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 das Element ab, das durch den Zweck der Miniaturansicht bestimmt wird.

public:
 IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode);
/// [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.

Gibt zurück

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

Attribute

Hinweise

In Windows 8 verfügt die GetThumbnailAsync-Methode über jeweils nur einen immersiven Monitor, der die Benutzeroberfläche der UWP-App anzeigen kann. In Windows 8.1 kann die Benutzeroberfläche der UWP-App auf mehreren Monitoren angezeigt werden, mit der Option, eine einzelne App gleichzeitig auf mehreren Monitoren anzuzeigen. Berücksichtigen Sie für die Skalierung mehrere Skalierungsfaktoren gleichzeitig.

In Windows 8.1 kann die GetThumbnailAsync-Methode eine Miniaturansicht einer beliebigen Größe zurückgeben. Daher sollten Apps, die lokale Bilder anzeigen, diese Methode aufrufen, um das skalierte Bild abzurufen, das sie anzeigen möchten. Dadurch wird sichergestellt, dass Apps von allen Cache- und Leistungsoptimierungen profitieren, einschließlich eines speziellen Mechanismus zum Abrufen von Miniaturansichten aus der Cloud, ohne die vollständige Datei herunterzuladen.

Weitere Informationen

Gilt für:

GetThumbnailAsync(ThumbnailMode, UInt32)

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

public:
 IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize);
/// [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.

requestedSize
UInt32

unsigned int

uint32_t

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

Wenn Windows kein Miniaturbild 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 eine Miniaturansicht zurückgegeben, die 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 Miniaturansichtsbild zugeordnet ist.

Attribute

Weitere Informationen

Gilt für:

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

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

public:
 IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options);
/// [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.

requestedSize
UInt32

unsigned int

uint32_t

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

Wenn Windows kein Miniaturbild 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 eine Miniaturansicht zurückgegeben, die 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 Geschwindigkeit des Abrufs des Miniaturbilds auswirken.

Gibt zurück

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

Attribute

Weitere Informationen

Gilt für: