StorageItemThumbnail 类

定义

命名空间:

Windows.Storage.FileProperties

表示与系统资源关联的缩略图图像， (如文件或文件夹) 。

public ref class StorageItemThumbnail sealed : IClosable, IRandomAccessStreamWithContentType

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemThumbnail final : IClosable, IRandomAccessStreamWithContentType

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemThumbnail : System.IDisposable, IRandomAccessStreamWithContentType

Public NotInheritable Class StorageItemThumbnail
Implements IDisposable, IRandomAccessStreamWithContentType

继承

Object Platform::Object IInspectable StorageItemThumbnail

属性

ContractVersionAttribute

实现

IClosable IDisposable IContentTypeProvider IInputStream IOutputStream IRandomAccessStream IRandomAccessStreamWithContentType

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

此示例演示如何获取文件的缩略图。

// Set query options with filter and sort order for results
List<string> fileTypeFilter = new List<string>();
fileTypeFilter.Add(".jpg");
fileTypeFilter.Add(".png");
fileTypeFilter.Add(".bmp");
fileTypeFilter.Add(".gif");
var queryOptions = new QueryOptions(CommonFileQuery.OrderByName, fileTypeFilter);

// Create query and retrieve files.
var query = KnownFolders.PicturesLibrary.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList<StorageFile> fileList = await query.GetFilesAsync();
// Process results
foreach (StorageFile file in fileList)
{
    // Get thumbnail
    const uint requestedSize = 190;
    const ThumbnailMode thumbnailMode = ThumbnailMode.PicturesView;
    const ThumbnailOptions thumbnailOptions = ThumbnailOptions.UseCurrentScale;
    var thumbnail = await file.GetThumbnailAsync(thumbnailMode, requestedSize, thumbnailOptions);
}

GetThumbnailAsync 完成后，缩略图将获取 StorageItemThumbnail 对象。

在示例中， file 变量获取一个 StorageFile ，表示要为其检索缩略图的每个文件。 我们使用查询来获取存储在变量) (file 这些文件的 StorageFile 对象，但你可以使用最适合你的应用的任何方法来获取 StorageFile 对象 (，例如通过文件选取器) 。

注解

可以通过表示许多文件系统资源的Windows 运行时对象获取缩略图。 其中许多对象都有方法或属性，这些方法或属性可让你获取 (，有时) 表示与特定资源关联的缩略图的 StorageItemThumbnail 进行设置。

若要了解如何获取特定Windows 运行时对象的缩略图，请参阅该对象的文档。 例如，若要获取文件的缩略图，可以调用 StorageFile.getThumbnailAsync 方法之一，或者若要获取联系人的缩略图，可以使用 Contact.thumbnail 属性。

有关检索缩略图的更多代码示例，请参阅 文件夹枚举示例 和 文件缩略图示例。

属性

CanRead	获取一个值，该值指示是否可以从中读取缩略图流。
CanWrite	获取一个值，该值指示缩略图流是否可以写入。
ContentType	获取缩略图的 MIME 内容类型。
OriginalHeight	获取原始 (未缩放) 缩略图的高度。
OriginalWidth	获取原始 (未缩放) 缩略图的宽度。
Position	获取缩略图流的字节偏移量。
ReturnedSmallerCachedSize	获取一个值，该值指示返回的缩略图图像是否为较小大小的缓存版本。
Size	获取或设置缩略图的大小。
Type	获取一个值，该值指示缩略图是图标还是图像。

方法

CloneStream()	基于由当前 storageItemThumbnail 对象表示的缩略图创建新的流。
Close()	释放由 Windows 运行时 对象公开的系统资源。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
FlushAsync()	在顺序流中异步刷新数据。
GetInputStreamAt(UInt64)	以未编码流的形式检索缩略图图像数据。
GetOutputStreamAt(UInt64)	检索输出流对象，用于将缩略图图像数据写入存储项。
ReadAsync(IBuffer, UInt32, InputStreamOptions)	返回异步字节读取器对象。
Seek(UInt64)	将缩略图流的偏移量设置为指定值。
WriteAsync(IBuffer)	在顺序流中异步写入数据。

另请参阅

• StorageFile
• 文件和文件夹缩略图示例 (Windows 10)