縮圖影像

下列指導方針描述如何使用縮圖影像協助使用者預覽檔案，在您的 UWP 應用程式中瀏覽時。

重要 API

• ThumbnailMode

我的應用程式應該包含縮圖嗎？

如果您的應用程式允許使用者瀏覽檔案，您可以顯示縮圖影像，協助使用者快速預覽這些檔案。

使用縮圖的時機：

• 顯示圖庫集合中多個項目的預覽 (像是檔案和資料夾)。 例如，影像中心應該使用縮圖提供每個圖片的小視圖給使用者，在使用者瀏覽其相片檔案時。

  

• 顯示清單中各別項目的預覽 (例如特定檔案)。 例如，使用者可能想要查看有關檔案的更多資訊，包括方便預覽的較大縮圖，再決定是否要開啟檔案。

  

可行與禁止事項

• 指定縮圖模式 (PicturesView、VideosView、DocumentsView、MusicView、ListView 或 SingleItem)，當您擷取縮圖時。 這樣可確保縮圖影像最佳化，顯示使用者想要看見的檔案類型。

  • 使用 SingleItem 模式擷取單一項目的縮圖，無論檔案類型為何。 其他縮圖模式適用於顯示多個檔案的預覽。

• 顯示一般預留位置影像，取代縮圖載入時的縮圖。 使用預留位置幫助應用程式變得回應更快，因為使用者可以在縮圖載入前與預覽互動。

  預留位置影像應該是：

  • 要取代的項目類型所專屬。 例如，資料夾、圖片及影片應該都有自己專用的預留位置。
  • 與要取代的縮圖影像的大小與外觀比例相同。
  • 一直顯示，直到縮圖影像載入完成。

• 使用包含文字標籤的預留位置影像來代表資料夾和檔案群組，以便與個別檔案加以區別。

• 如果您無法擷取縮圖，請顯示預留位置影像。

• 提供文件和音樂檔案的預覽時，顯示其他檔案資訊。 然後使用者就可以找出縮圖影像可能還未提供的檔案重要資訊。 例如，若是音樂檔案，您可顯示演出者的姓名以及專輯封面的縮圖。

• 不要顯示圖片及影片檔案的其他檔案資訊。 在大多數情況下，縮圖影像就已足夠，可讓使用者瀏覽圖片和影片。

其他用法指導方針

建議的縮圖模式與其功能：

以下範例顯示擷取的縮圖影像根據檔案類型與縮圖模式的差異：

項目類型	使用下列方式擷取時： PicturesView VideosView	使用下列方式擷取時： DocumentsView MusicView ListView	使用下列方式擷取時： SingleItem
圖片	縮圖影像使用約 .7 的統一寬外觀比例 (如果慣用的大小為 190，則為 190 x 130)。	縮圖會裁剪成正方形外觀比例。	縮圖影像使用檔案的原始外觀比例。
影片	縮圖有圖示，可與圖片區分。	縮圖會裁剪成正方形外觀比例。	縮圖影像使用檔案的原始外觀比例。
音樂	縮圖有適當大小的背景圖示。 背景色彩是由應用程式的磚背景色彩決定。	如果檔案有專輯封面，縮圖就是專輯封面。 否則，縮圖有適當大小的背景圖示。	如果檔案有專輯封面，則縮圖就是專輯封面，並採用檔案的原始外觀比例。 否則，縮圖會是圖示。
文件	縮圖有適當大小的背景圖示。 背景色彩是由應用程式的磚背景色彩決定。	縮圖有適當大小的背景圖示。 背景色彩是由應用程式的磚背景色彩決定。	文件縮圖 (如果有的話)。 否則，縮圖會是圖示。
Folder	如果資料夾中有圖片檔案，則會使用圖片縮圖。 否則不會擷取任何縮圖。	不會擷取任何縮圖影像。	縮圖是資料夾圖示。
檔案群組	如果資料夾中有圖片檔案，則會使用圖片縮圖。 否則不會擷取任何縮圖。	如果群組中的檔案當中有某一個檔案有專輯封面，則縮圖會是專輯封面。 否則不會擷取任何縮圖。	如果群組中的檔案當中有某一個檔案有專輯封面，則縮圖會是專輯封面，並使用檔案的原始外觀比例。 否則，縮圖會是代表檔案群組的圖示。

相關主題

• ThumbnailMode 列舉
• StorageItemThumbnail 類別
• StorageFile 類別 \(英文\)
• 檔案和資料夾縮圖範例 (GitHub)
• 清單和方格檢視