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)