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)