IStorageItemProperties.GetThumbnailAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| GetThumbnailAsync(ThumbnailMode) |
擷取專案的調整縮圖影像，此影像取決於縮圖的目的。 |
| GetThumbnailAsync(ThumbnailMode, UInt32) |
擷取專案的調整縮圖影像，取決於縮圖的目的和要求的大小。 |
| GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
擷取專案的調整縮圖影像，此影像取決於縮圖的目的、要求的大小和指定的選項。 |
GetThumbnailAsync(ThumbnailMode)
擷取專案的調整縮圖影像，此影像取決於縮圖的目的。
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)參數
- mode
- ThumbnailMode
描述縮圖用途的列舉值，並決定縮圖影像的調整方式。
傳回
當此方法成功完成時，它會傳回代表縮圖影像的 StorageItemThumbnail ，如果沒有與專案相關聯的縮圖影像，則會傳回 null 。
- 屬性
備註
在 Windows 8 中， GetThumbnailAsync 方法一次只有一個沉浸式監視器，可以顯示 UWP 應用程式使用者介面。 在Windows 8.1中，UWP 應用程式使用者介面可以出現在多個監視器上，而且可以選擇同時在多個監視器上顯示單一應用程式。 若要調整，請考慮一次多個縮放比例。
在Windows 8.1中，GetThumbnailAsync方法可以傳回任何大小縮圖。 因此，顯示本機圖片的應用程式應該呼叫此方法，以取得想要顯示的縮放影像。 這可確保應用程式受益于所有快取和效能優化，包括從雲端取得縮圖的特殊機制，而不需要下載完整檔案。
另請參閱
適用於
GetThumbnailAsync(ThumbnailMode, UInt32)
擷取專案的調整縮圖影像，取決於縮圖的目的和要求的大小。
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)參數
- mode
- ThumbnailMode
描述縮圖用途的列舉值，並決定縮圖影像的調整方式。
- requestedSize
-
UInt32
unsigned int
uint32_t
縮圖最長邊緣的要求大小，以圖元為單位。 Windows 會使用 requestedSize 作為指南，並嘗試調整縮圖影像，而不需要減少影像的品質。
如果 Windows 找不到可調整以符合要求大小的縮圖影像，可能會傳回較大的縮圖。 如果沒有較大的縮圖可用，可能會傳回小於要求大小的縮圖影像。
傳回
當此方法成功完成時，它會傳回代表縮圖影像的 StorageItemThumbnail ，如果沒有與專案相關聯的縮圖影像，則會傳回 null 。
- 屬性
另請參閱
適用於
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
擷取專案的調整縮圖影像，此影像取決於縮圖的目的、要求的大小和指定的選項。
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)參數
- mode
- ThumbnailMode
描述縮圖用途的列舉值，並決定縮圖影像的調整方式。
- requestedSize
-
UInt32
unsigned int
uint32_t
縮圖最長邊緣的要求大小，以圖元為單位。 Windows 會使用 requestedSize 作為指南，並嘗試調整縮圖影像，而不需要減少影像的品質。
如果 Windows 找不到可調整以符合要求大小的縮圖影像，可能會傳回較大的縮圖。 如果沒有較大的縮圖可用，可能會傳回小於要求大小的縮圖影像。
- options
- ThumbnailOptions
列舉值，描述用來擷取縮圖影像所需的行為。 指定的行為可能會影響影像的大小和/或品質，以及擷取縮圖影像的速度。
傳回
當此方法成功完成時，它會傳回代表縮圖影像的 StorageItemThumbnail ，如果沒有與專案相關聯的縮圖影像，則會傳回 null 。
- 屬性