共用方式為


IStorageItemProperties.GetThumbnailAsync 方法

定義

多載

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

屬性

另請參閱

適用於