Gambar mini

Panduan ini menjelaskan cara menggunakan gambar mini untuk membantu pengguna mempratinjau file saat mereka menjelajahi aplikasi WinUI Anda.

API Penting

• ThumbnailMode

Haruskah aplikasi saya menyertakan gambar mini?

Jika aplikasi memungkinkan pengguna menelusuri file, Anda dapat menampilkan gambar mini untuk membantu pengguna mempratinjau 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.

  

Hal yang boleh dan tidak boleh dilakukan

• Tentukan mode thumbnail (PicturesView, VideosView, DocumentsView, MusicView, ListView, atau SingleItem) saat Anda mengambil kembali thumbnail. 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 pengganti umum sebagai pengganti gambar mini selama gambar mini dimuat. Menggunakan penyangga membantu aplikasi Anda tampak lebih responsif karena pengguna dapat berinteraksi dengan elemen pratinjau sebelum gambar mini dimuat.

  Gambar penampung harus:

  • Khusus untuk jenis item yang diwakilinya. Misalnya, folder, gambar, dan video semuanya harus memiliki tempat penampung khusus mereka sendiri.
  • Ukuran dan rasio aspek yang sama dengan gambar mini yang diwakilinya.
  • Akan 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 penampung.

• Tampilkan informasi file tambahan saat menyediakan pratinjau untuk file dokumen dan musik. Pengguna kemudian dapat mengidentifikasi informasi utama tentang file yang mungkin tidak mudah diakses hanya dari gambar mini. Misalnya, untuk file musik, Anda mungkin menampilkan nama artis bersama dengan thumbnail dari sampul album.

• Jangan tampilkan info file tambahan untuk file gambar dan video. Dalam kebanyakan kasus, gambar pratinjau cukup untuk pengguna yang menelusuri gambar dan video.

Panduan penggunaan tambahan

Mode thumbnail yang direkomendasikan dan fitur-fiturnya:

Tampilkan pratinjau untuk	Mode gambar mini	Fitur gambar mini yang diambil
Pictures Video	Pemandangan Gambar Tampilan Video	Ukuran: Sedang, sebaiknya setidaknya 190 (jika ukuran gambar adalah 190x130) Rasio aspek: Seragam, rasio aspek luas sekitar 0,7 (190x130 jika ukurannya adalah 190) Dipotong untuk keperluan pratinjau. Baik untuk menyelaraskan gambar dalam grid karena rasio aspeknya yang seragam.
Documents Musik	TampilanDokumen MusicView ListView	Ukuran: Kecil, sebaiknya minimal 40 x 40 piksel Rasio aspek: Seragam, rasio aspek berbentuk persegi Bagus untuk mempratinjau sampul album karena rasio aspeknya yang persegi. Dokumen terlihat sama seperti yang terlihat di jendela pemilih file (menggunakan ikon yang sama).
Item apapun (terlepas dari jenis file)	ItemTunggal	Ukuran: Kecil, sebaiknya minimal 40 x 40 piksel Rasio aspek: Seragam, rasio aspek berbentuk persegi Bagus untuk mempratinjau sampul album karena rasio aspeknya yang 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 barang	Saat diambil menggunakan: Pemandangan Gambar TampilanVideo	Saat diambil menggunakan: TampilanDokumen MusicView ListView	Saat diambil menggunakan: ItemTunggal
Gambar	Gambar mini menggunakan rasio aspek lebar yang seragam sekitar 0,7 (190 x 130 jika ukuran lebar yang disukai adalah 190).	Gambar mini dipotong ke rasio aspek persegi.	Gambar mini menggunakan rasio aspek asli dari file.
Video	Thumbnail memiliki ikon yang membedakannya dari gambar.	Cuplikan gambar dipotong ke rasio aspek persegi.	Gambar thumbnail menggunakan rasio aspek asli dari file.
Music	Cuplikan gambar adalah ikon pada latar belakang berukuran sesuai. Warna latar belakang ditentukan oleh warna latar belakang petak aplikasi.	Jika file memiliki sampul album, maka thumbnail adalah sampul album. Jika tidak, thumbnail adalah ikon pada latar belakang dengan ukuran yang tepat.	Jika file memiliki gambar sampul album, maka thumbnail tersebut adalah gambar sampul album dengan rasio aspek asli dari file. Jika tidak, thumbnail adalah ikon.
Dokumen	Gambar mini adalah ikon pada latar belakang dengan ukuran yang sesuai. Warna latar belakang ditentukan oleh warna latar belakang petak aplikasi.	Gambar mini adalah ikon pada latar belakang dengan ukuran yang sesuai. Warna latar belakang ditentukan oleh warna latar belakang ubin aplikasi.	Gambar mini dokumen, jika ada. Jika tidak, gambar mini adalah ikon.
Folder	Jika ada file gambar dalam folder, thumbnail gambar akan digunakan. Jika tidak, tidak ada gambar mini yang diperoleh.	Tidak ada gambar mini yang ditemukan.	Gambar mini adalah ikon folder.
Kelompok berkas	Jika ada file gambar dalam folder, thumbnail 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 gambar sampul album di antara file-file dalam grup, maka gambar mini tersebut adalah gambar sampul album tersebut dan menggunakan rasio aspek asli dari file tersebut. Sebaliknya, gambar mini adalah ikon yang mewakili sekelompok file.

Topik terkait

• Enum ThumbnailMode
• Kelas StorageItemThumbnail
• Kelas StorageFile
• Sampel gambar mini file dan folder (GitHub)
• Tampilan daftar dan kisi