导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

StorageFile.GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) | getThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) Method

针对文件检索调整的缩略图图像,这取决于缩略图的用途、要求的大小以及指定的选项。

语法


storageFile.getThumbnailAsync(mode, requestedSize, options).done( /* 你的成功和错误处理程序 */ );

参数

mode

类型: ThumbnailMode

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

有关选择最合适的缩略图模式的指南,请参见 缩略图的指南和检查表

requestedSize

类型: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

缩略图的最长边缘要求的大小(以像素为单位)。Windows 将 requestedSize 用作准则并在未降低图像质量的情况下尝试缩放缩略图图像。

如果 Windows 无法找到它可以伸缩以满足请求的范围的缩略图图像,则可能会返回较大的缩略图。如果没有较大的缩略图可用,则可能会返回小于请求的大小的缩略图图像。

options

类型: ThumbnailOptions

描述所需的行为的枚举值可用于检索缩略图像。指定的行为可能影响图像的大小和/或质量,和缩略图象快速检索速度。

返回值

类型: IAsyncOperation<StorageItemThumbnail>

此方法成功完成时,如果没有缩略图象与文件关联,则它将返回表示的缩略图图像或 nullStorageItemThumbnail

备注

Windows Phone 8

此 API 不实现,但是调用时会引发异常。请参见 Windows Phone 运行时 API

示例

此示例显示如何通过使用 storageFile.getThumbnailAsync(mode, requestedSize, options) 方法捕获文件的缩略图。


storageFile.getThumbnailAsync(
    Windows.Storage.FileProperties.ThumbnailMode.musicView,
    100,
    Windows.Storage.FileProperties.ThumbnailOptions.useCurrentScale).then(
        function (storageItemThumbnail) {
            // Add code to process thumbnail
        }
    );

您必须具有表示您的文件的 StorageFile 对象(示例中 storageFile)以便使用 StorageFile.GetThumbnailAsync 方法之一。

要求

最低受支持的客户端

Windows 8

最低受支持的服务器

Windows Server 2012

最低受支持的电话

Windows Phone 8 [未执行,请参阅“备注”]

命名空间

Windows.Storage
Windows::Storage [C++]

元数据

Windows.winmd

另请参阅

GetThumbnailAsync(ThumbnailMode)
GetThumbnailAsync(ThumbnailMode, UInt32)
StorageFile
ThumbnailOptions

 

 

显示:
© 2014 Microsoft