Gambar mini

Artikel
08/25/2023

Panduan ini menjelaskan cara menggunakan gambar mini untuk membantu pengguna mempratinjau file saat mereka menelusuri di aplikasi UWP Anda.

API penting

ThumbnailMode

Haruskah aplikasi saya menyertakan gambar mini?

Jika aplikasi Memungkinkan pengguna menelusuri file, Anda dapat menampilkan gambar mini untuk membantu pengguna melihat pratinjau file tersebut dengan cepat.

Gunakan gambar mini saat:

Menampilkan pratinjau untuk banyak item dalam koleksi galeri (seperti file dan folder). Misalnya, galeri foto harus menggunakan gambar mini untuk memberi pengguna tampilan kecil dari setiap gambar saat mereka menelusuri file foto mereka.
Menampilkan pratinjau untuk item individual dalam daftar (seperti file tertentu). Misalnya, pengguna mungkin ingin melihat informasi selengkapnya tentang file, termasuk gambar mini yang lebih besar untuk pratinjau yang lebih baik, sebelum memutuskan apakah akan membuka file.

Lakukan dan jangan lakukan

Tentukan mode gambar mini (PicturesView, VideosView, DocumentsView, MusicView, ListView, atau SingleItem) saat Anda mengambil gambar mini. Ini memastikan bahwa gambar mini dioptimalkan untuk menampilkan jenis file yang ingin dilihat pengguna.
- Gunakan mode SingleItem untuk mengambil gambar mini untuk satu item, terlepas dari jenis file. Mode gambar mini lainnya dimaksudkan untuk menampilkan pratinjau beberapa file.
Tampilkan gambar tempat penampung umum sebagai pengganti gambar mini saat gambar mini dimuat. Menggunakan tempat penampung membantu aplikasi Anda tampak lebih responsif karena pengguna dapat berinteraksi dengan pratinjau sebelum pemuatan gambar mini.

Gambar tempat penampung harus:
- Khusus untuk jenis item yang ada di dalamnya. Misalnya, folder, gambar, dan video semuanya harus memiliki tempat penampung khusus mereka sendiri.
- Ukuran dan rasio aspek yang sama dengan gambar mini tempatnya berdiri.
- Ditampilkan hingga gambar mini dimuat.
Gunakan gambar tempat penampung dengan label teks untuk mewakili folder dan grup file untuk membedakan dari file individual.
Jika Anda tidak dapat mengambil gambar mini, tampilkan gambar tempat penampung.
Tampilkan informasi file tambahan saat menyediakan pratinjau untuk file dokumen dan musik. Pengguna kemudian dapat mengidentifikasi informasi utama tentang file yang mungkin tidak tersedia dari gambar mini saja. Misalnya, untuk file musik, Anda mungkin menampilkan nama artis bersama dengan gambar mini seni album.
Jangan tampilkan info file tambahan untuk file gambar dan video. Dalam kebanyakan kasus, gambar mini cukup untuk pengguna yang menelusuri gambar dan video.

Panduan penggunaan tambahan

Mode gambar mini yang direkomendasikan dan fiturnya:

Tampilkan pratinjau untuk	Mode gambar mini	Fitur gambar mini yang diambil
Foto Video	GambarTampilan Gambaran Video	Ukuran: Sedang, sebaiknya setidaknya 190 (jika ukuran gambar adalah 190x130) Rasio aspek: Seragam, rasio aspek lebar sekitar .7 (190x130 jika ukurannya adalah 190) Dipotong untuk pratinjau. Baik untuk menyelaraskan gambar dalam kisi karena rasio aspek yang seragam.
Dokumen Musik	DocumentsView MusicView ListView	Ukuran: Kecil, sebaiknya minimal 40 x 40 piksel Rasio aspek: Seragam, rasio aspek persegi Bagus untuk mempratinjau seni album karena rasio aspek persegi. Dokumen terlihat sama seperti yang terlihat di jendela pemilih file (menggunakan ikon yang sama).
Item tunggal apa pun (terlepas dari jenis file)	SingleItem	Ukuran: Kecil, sebaiknya minimal 40 x 40 piksel Rasio aspek: Seragam, rasio aspek persegi Bagus untuk mempratinjau seni album karena rasio aspek persegi. Dokumen terlihat sama seperti yang terlihat di jendela pemilih file (menggunakan ikon yang sama).

Berikut adalah contoh yang menunjukkan bagaimana gambar mini yang diambil berbeda tergantung pada jenis file dan mode gambar mini:

Tipe item	Saat diambil menggunakan: GambarTampilan Gambaran Video	Saat diambil menggunakan: DocumentsView MusicView ListView	Saat diambil menggunakan: SingleItem
Gambar	Gambar mini menggunakan rasio aspek lebar yang seragam sekitar .7 (190 x 130 jika ukuran yang disukai adalah 190).	Gambar mini dipotong ke rasio aspek persegi.	Gambar mini menggunakan rasio aspek asli file.
Video	Gambar mini memiliki ikon yang membedakannya dari gambar.	Gambar mini dipotong ke rasio aspek persegi.	Gambar mini menggunakan rasio aspek asli file.
Musik	Gambar mini adalah ikon pada latar belakang dengan ukuran yang sesuai. Warna latar belakang ditentukan oleh warna latar belakang petak peta aplikasi.	Jika file memiliki seni album, thumbnail adalah seni album. Jika tidak, gambar mini adalah ikon pada latar belakang dengan ukuran yang sesuai.	Jika file memiliki seni album, thumbnail adalah seni album dengan rasio aspek asli file. Jika tidak, gambar mini adalah ikon.
Dokumen	Gambar mini adalah ikon pada latar belakang dengan ukuran yang sesuai. Warna latar belakang ditentukan oleh warna latar belakang petak peta aplikasi.	Gambar mini adalah ikon pada latar belakang dengan ukuran yang sesuai. Warna latar belakang ditentukan oleh warna latar belakang petak peta aplikasi.	Gambar mini dokumen, jika ada. Jika tidak, gambar mini adalah ikon.
Folder	Jika ada file gambar dalam folder, gambar mini gambar akan digunakan. Jika tidak, tidak ada gambar mini yang diambil.	Tidak ada gambar mini yang diambil.	Gambar mini adalah ikon folder.
Grup file	Jika ada file gambar dalam folder, gambar mini gambar akan digunakan. Jika tidak, tidak ada gambar mini yang diambil.	Jika ada file yang memiliki seni album di antara file dalam grup, gambar mini adalah seni album. Jika tidak, tidak ada gambar mini yang diambil.	Jika ada file yang memiliki seni album di antara file dalam grup, gambar mini adalah seni album dan menggunakan rasio aspek asli file. Jika tidak, gambar mini adalah ikon yang mewakili sekelompok file.