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 。
- 属性