StorageItemThumbnail クラス

定義

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 の要件

例

この例では、ファイルのサムネイルを取得する方法を示します。

// 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 プロパティを使用します。

サムネイルの取得に関するその他のコード サンプルについては、 フォルダー列挙のサンプル と ファイルサムネイルのサンプルを参照してください。

プロパティ

メソッド

適用対象

こちらもご覧ください

• StorageFile
• ファイルとフォルダーのサムネイルサンプル (Windows 10)