IStorageItemProperties.GetThumbnailAsync 方法

定義

命名空間:

Windows.Storage

多載

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

描述縮圖用途的列舉值，並決定縮圖影像的調整方式。

傳回

IAsyncOperation<StorageItemThumbnail>

當此方法成功完成時，它會傳回代表縮圖影像的 StorageItemThumbnail ，如果沒有與專案相關聯的縮圖影像，則會傳回 null 。

屬性

OverloadAttribute RemoteAsyncAttribute

備註

在 Windows 8 中， GetThumbnailAsync 方法一次只有一個沉浸式監視器，可以顯示 UWP 應用程式使用者介面。 在Windows 8.1中，UWP 應用程式使用者介面可以出現在多個監視器上，而且可以選擇同時在多個監視器上顯示單一應用程式。 若要調整，請考慮一次多個縮放比例。

在Windows 8.1中，GetThumbnailAsync方法可以傳回任何大小縮圖。 因此，顯示本機圖片的應用程式應該呼叫此方法，以取得想要顯示的縮放影像。 這可確保應用程式受益于所有快取和效能優化，包括從雲端取得縮圖的特殊機制，而不需要下載完整檔案。

另請參閱

• GetThumbnailAsync(ThumbnailMode, UInt32)
• GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

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 找不到可調整以符合要求大小的縮圖影像，可能會傳回較大的縮圖。 如果沒有較大的縮圖可用，可能會傳回小於要求大小的縮圖影像。

傳回

IAsyncOperation<StorageItemThumbnail>

當此方法成功完成時，它會傳回代表縮圖影像的 StorageItemThumbnail ，如果沒有與專案相關聯的縮圖影像，則會傳回 null 。

屬性

OverloadAttribute RemoteAsyncAttribute

另請參閱

• GetThumbnailAsync(ThumbnailMode)
• GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

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

列舉值，描述用來擷取縮圖影像所需的行為。 指定的行為可能會影響影像的大小和/或品質，以及擷取縮圖影像的速度。

傳回

IAsyncOperation<StorageItemThumbnail>

當此方法成功完成時，它會傳回代表縮圖影像的 StorageItemThumbnail ，如果沒有與專案相關聯的縮圖影像，則會傳回 null 。

屬性

OverloadAttribute RemoteAsyncAttribute

另請參閱

• GetThumbnailAsync(ThumbnailMode)
• GetThumbnailAsync(ThumbnailMode, UInt32)