サムネイル画像

これらのガイドラインでは、サムネイル画像を使用して、ユーザーが WinUI アプリで参照するファイルをプレビューする方法について説明します。

重要な API

ThumbnailMode

アプリにサムネイルを含める必要がありますか?

アプリでユーザーがファイルを参照できる場合は、サムネイル画像を表示して、ユーザーがそれらのファイルをすばやくプレビューできるようにすることができます。

サムネイルは次の場合に使用します。

ギャラリーコレクション内の多くの項目 (ファイルやフォルダーなど) のプレビューを表示する。たとえば、フォトギャラリーでは、サムネイルを使用して、ユーザーが写真ファイルを参照する際に各画像の小さなビューを表示する必要があります。
リスト内の個々のアイテムのプレビューを表示する (特定のファイルなど)。たとえば、ユーザーは、ファイルを開くかどうかを決定する前に、より大きなサムネイルを含むファイルに関する詳細情報を表示してプレビューを改善できます。

すべきこととやってはいけないこと

サムネイルを取得するときにサムネイルモード (PicturesView、VideosView、DocumentsView、MusicView、ListView、または SingleItem) を指定します。これにより、ユーザーが表示するファイルの種類を表示するようにサムネイル画像が最適化されます。
- ファイルの種類に関係なく、単一アイテムのサムネイルを取得するには、SingleItem モードを使用します。その他のサムネイルモードは、複数のファイルのプレビューを表示するためのものです。
サムネイルの読み込み中に、サムネイルの代わりに汎用プレースホルダー画像を表示します。プレースホルダーを使用すると、サムネイルを読み込む前にユーザーがプレビューを操作できるため、アプリの応答性が向上します。

プレースホルダーイメージは次のようになります。
- それが代わりとなる項目の種類に特有です。たとえば、フォルダー、画像、ビデオには、それぞれ専用のプレースホルダーが必要です。
- それが表すサムネイル画像と同じサイズと縦横比。
- サムネイル画像が読み込まれるまで表示されます。
テキストラベル付きのプレースホルダー画像を使用して、フォルダーとファイルグループを表し、個々のファイルと区別します。
サムネイルを取得できない場合は、プレースホルダー画像を表示します。
ドキュメントファイルと音楽ファイルのプレビューを提供するときに、追加のファイル情報を表示します。その後、ユーザーは、サムネイル画像だけではすぐに利用できない可能性があるファイルに関する重要な情報を識別できます。たとえば、音楽ファイルの場合、アルバムアートのサムネイルと共にアーティストの名前を表示できます。
画像ファイルとビデオファイルの追加のファイル情報を表示しないでください。ほとんどの場合、サムネイル画像は、ユーザーが画像やビデオを閲覧するのに十分です。

その他の使用ガイドライン

推奨されるサムネイルモードとその機能:

のプレビューを表示する	サムネイルモード	取得したサムネイル画像の機能
写真ビデオ	ピクチャービュー VideosView	サイズ: 中、できれば少なくとも 190 (画像サイズが 190 x 130 の場合) 縦横比: 約 .7 の均一で広い縦横比 (サイズが 190 の場合は 190 x 130) プレビュー用にトリミングされます。縦横比が均一なため、グリッド内の画像を整列する場合に適しています。
ドキュメント音楽	ドキュメントビュー MusicView ListView	サイズ: 小さい、好ましくは少なくとも 40 x 40 ピクセル縦横比: 均一、正方形の縦横比正方形の縦横比のため、アルバムアートのプレビューに適しています。ドキュメントは、ファイルピッカーウィンドウで表示されるのと同じように見えます (同じアイコンが使用されます)。
任意の 1 つの項目 (ファイルの種類に関係なく)	単一アイテム	サイズ: 小さい、好ましくは少なくとも 40 x 40 ピクセル縦横比: 均一、正方形の縦横比正方形の縦横比のため、アルバムアートのプレビューに適しています。ドキュメントは、ファイルピッカーウィンドウで表示されるのと同じように見えます (同じアイコンが使用されます)。

ファイルの種類とサムネイルモードによって取得されたサムネイル画像がどのように異なるかを示す例を次に示します。

アイテムの種類	次を使用して取得した場合: ピクチャービュー VideosView	次を使用して取得した場合: ドキュメントビュー MusicView ListView	次を使用して取得した場合: 単一アイテム
図	サムネイル画像は、約 .7 の均一で広い縦横比を使用します (推奨サイズが 190 の場合は 190 x 130)。	サムネイルは四角形の縦横比にトリミングされます。	サムネイル画像では、ファイルの元の縦横比が使用されます。
Video	サムネイルには、画像と区別するアイコンがあります。	サムネイルは四角形の縦横比にトリミングされます。	サムネイル画像では、ファイルの元の縦横比が使用されます。
音楽	サムネイルは、適切なサイズの背景にあるアイコンです。背景色は、アプリのタイルの背景色によって決まります。	ファイルにアルバムアートがある場合、サムネイルはアルバムアートです。それ以外の場合、サムネイルは適切なサイズの背景のアイコンです。	ファイルにアルバムアートがある場合、サムネイルはファイルの元の縦横比を持つアルバムアートです。それ以外の場合、サムネイルはアイコンです。
ドキュメント	サムネイルは、適切なサイズの背景にあるアイコンです。背景色は、アプリのタイルの背景色によって決まります。	サムネイルは、適切なサイズの背景にあるアイコンです。背景色は、アプリのタイルの背景色によって決まります。	ドキュメントのサムネイル (存在する場合)。それ以外の場合、サムネイルはアイコンです。
Folder	フォルダーに画像ファイルがある場合は、画像のサムネイルが使用されます。それ以外の場合、サムネイルは取得されません。	サムネイル画像は取得されません。	サムネイルはフォルダーアイコンです。
ファイルグループ	フォルダーに画像ファイルがある場合は、画像のサムネイルが使用されます。それ以外の場合、サムネイルは取得されません。	グループ内のファイルの中にアルバムアートを含むファイルがある場合、サムネイルはアルバムアートです。それ以外の場合、サムネイルは取得されません。	グループ内のファイルの中にアルバムアートを含むファイルがある場合、サムネイルはアルバムアートであり、ファイルの元の縦横比が使用されます。それ以外の場合、サムネイルはファイルのグループを表すアイコンです。