通过

StorageFile.GetScaledImageAsThumbnailAsync 方法

  • 参考

定义

命名空间:
Windows.Storage

重载

GetScaledImageAsThumbnailAsync(ThumbnailMode)

获取缩略图形式的缩放图像，由缩略图的用途确定。
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

获取缩略图形式的缩放图像，由缩略图的用途和请求的大小决定。
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

获取缩略图形式的缩放图像，由缩略图的用途、请求的大小和指定选项确定

GetScaledImageAsThumbnailAsync(ThumbnailMode)

编辑

获取缩略图形式的缩放图像，由缩略图的用途确定。

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode);
function getScaledImageAsThumbnailAsync(mode)
Public Function GetScaledImageAsThumbnailAsync (mode As ThumbnailMode) As IAsyncOperation(Of StorageItemThumbnail)

参数

mode
ThumbnailMode

描述缩略图用途并确定缩略图图像调整方式的枚举值。

有关选择最佳缩略图模式的指导，请参阅 缩略图指南和清单。

返回

IAsyncOperation<StorageItemThumbnail>

此方法成功完成后，它将返回 一个 StorageItemThumbnail ，表示缩略图图像;如果没有与该项关联的缩略图图像，则返回 null 。

实现

GetScaledImageAsThumbnailAsync(ThumbnailMode)
属性
OverloadAttribute RemoteAsyncAttribute

注解

虽然 GetThumbnailAsync 遵循缩略图磁盘缓存支持的最大大小，但 GetScaledImageAsThumbnailAsync 可以提取大于缩略图磁盘缓存支持的缩略图。 GetScaledImageAsThumbnailAsync 提供了最佳质量，但如果缩略图太大，则不使用磁盘缓存可能会影响性能。

另请参阅

适用于

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

编辑

获取缩略图形式的缩放图像，由缩略图的用途和请求的大小决定。

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode, uint requestedSize);
function getScaledImageAsThumbnailAsync(mode, requestedSize)
Public Function GetScaledImageAsThumbnailAsync (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 。

实现

M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t)
属性
OverloadAttribute RemoteAsyncAttribute

注解

虽然 GetThumbnailAsync 遵循缩略图磁盘缓存支持的最大大小，但 GetScaledImageAsThumbnailAsync 可以提取大于缩略图磁盘缓存支持的缩略图。 GetScaledImageAsThumbnailAsync 提供了最佳质量，但如果缩略图太大，则不使用磁盘缓存可能会影响性能。

另请参阅

适用于

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

编辑

获取缩略图形式的缩放图像，由缩略图的用途、请求的大小和指定选项确定

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize, ThumbnailOptions const& options);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode, uint requestedSize, ThumbnailOptions options);
function getScaledImageAsThumbnailAsync(mode, requestedSize, options)
Public Function GetScaledImageAsThumbnailAsync (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 。

实现

M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t,Windows.Storage.FileProperties.ThumbnailOptions)
属性
OverloadAttribute RemoteAsyncAttribute

注解

虽然 GetThumbnailAsync 遵循缩略图磁盘缓存支持的最大大小，但 GetScaledImageAsThumbnailAsync 可以提取大于缩略图磁盘缓存支持的缩略图。 GetScaledImageAsThumbnailAsync 提供了最佳质量，但如果缩略图太大，则不使用磁盘缓存可能会影响性能。

另请参阅

适用于