IStorageItemProperties.GetThumbnailAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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