Immagini in miniatura

Queste linee guida descrivono come usare le immagini di anteprima per aiutare gli utenti a visualizzare in anteprima i file mentre esplorano nell'app WinUI.

API Importanti

• ThumbnailMode

La mia app dovrebbe includere anteprime?

Se l'app consente agli utenti di esplorare i file, è possibile visualizzare immagini di anteprima per consentire agli utenti di visualizzare rapidamente l'anteprima di tali file.

Usare le anteprime quando:

• Visualizzazione di anteprime per molti elementi in una raccolta di gallerie, ad esempio file e cartelle. Ad esempio, una raccolta foto deve usare le anteprime per offrire agli utenti una piccola visualizzazione di ogni immagine mentre esplorano i file di foto.

  

• Visualizzazione di un'anteprima per un singolo elemento in un elenco (ad esempio un file specifico). Ad esempio, l'utente potrebbe voler visualizzare altre informazioni su un file, inclusa un'anteprima più grande per un'anteprima migliore, prima di decidere se aprire il file.

  

Procedure rischiose e procedure consigliate

• Specificare la modalità di anteprima (PicturesView, VideosView, DocumentsView, MusicView, ListView o SingleItem) quando si recuperano le anteprime. Ciò garantisce che le immagini di anteprima siano ottimizzate per visualizzare il tipo di file che gli utenti vogliono visualizzare.

  • Utilizzare la modalità SingleItem per recuperare un'anteprima per un singolo elemento, indipendentemente dal tipo di file. Le altre modalità di anteprima sono progettate per visualizzare le anteprime di più file.

• Visualizzare immagini segnaposto generiche al posto delle anteprime durante il caricamento delle anteprime. L'uso dei segnaposto consente di far sembrare l'app più reattiva perché gli utenti possono interagire con le anteprime prima del caricamento della miniatura.

  Le immagini segnaposto devono essere:

  • Specifico del tipo di elemento che rappresenta. Ad esempio, cartelle, immagini e video devono avere tutti segnaposto specifici.
  • Le stesse dimensioni e proporzioni dell'immagine di anteprima che sostituisce.
  • Viene visualizzato fino al caricamento dell'immagine di anteprima.

• Usare immagini segnaposto con etichette di testo per rappresentare cartelle e gruppi di file per differenziare i singoli file.

• Se non riesci a recuperare un'anteprima, visualizza un'immagine segnaposto.

• Visualizzare informazioni aggiuntive sui file quando si forniscono anteprime per i file di documenti e musica. Gli utenti possono quindi identificare le informazioni chiave su un file che potrebbe non essere facilmente disponibile da un'immagine di anteprima. Ad esempio, per un file musicale, è possibile visualizzare il nome dell'artista insieme all'anteprima dell'arte dell'album.

• Non visualizzare informazioni aggiuntive sul file per i file immagine e video. Nella maggior parte dei casi, un'immagine di anteprima è sufficiente per gli utenti che esplorano immagini e video.

Linee guida aggiuntive sull'utilizzo

Modalità di anteprima consigliate e relative funzionalità:

Visualizzare le anteprime per	Modalità di anteprima	Funzionalità delle immagini di anteprima recuperate
Pictures Video	PicturesView VideoVisualizzazione	Dimensioni: medio, preferibilmente almeno 190 (se la dimensione dell'immagine è 190x130) Proporzioni: proporzioni uniformi e ampie di circa 7 (190x130 se la dimensione è 190) Ritagliato per le anteprime. Adatto per l'allineamento delle immagini in una griglia a causa di proporzioni uniformi.
Documents Musica	DocumentsView MusicView ListView	Dimensioni: piccole, preferibilmente almeno 40 x 40 pixel Rapporto d'aspetto: Uniforme, formato quadrato Buona per l'anteprima della copertina dell'album grazie alle proporzioni quadrate. I documenti hanno lo stesso aspetto di una finestra di selezione file (usa le stesse icone).
Qualsiasi singolo elemento (indipendentemente dal tipo di file)	ElementoSingolo	Dimensioni: piccole, preferibilmente almeno 40 x 40 pixel Rapporto d'aspetto: Uniforme, formato quadrato Buona per l'anteprima della copertina dell'album grazie alle proporzioni quadrate. I documenti hanno lo stesso aspetto di una finestra di selezione file (usa le stesse icone).

Ecco alcuni esempi che illustrano come le immagini di anteprima recuperate differiscono a seconda del tipo di file e della modalità di anteprima:

Tipo di elemento	Quando viene recuperato tramite: PicturesView VideoVisualizzazione	Quando viene recuperato tramite: DocumentsView MusicView ListView	Quando viene recuperato tramite: ElementoSingolo
Immagine	L'immagine di anteprima usa proporzioni uniformi e ampie di circa 7 (190 x 130 se la dimensione preferita è 190).	La miniatura viene ritagliata in un rapporto d'aspetto quadrato.	L'immagine di anteprima usa le proporzioni originali del file.
Video	L'anteprima ha un'icona che la differenzia dalle immagini.	La miniatura viene ritagliata in un rapporto d'aspetto quadrato.	L'immagine di anteprima usa le proporzioni originali del file.
Music	La miniatura è un'icona su uno sfondo di dimensioni appropriate. Il colore di sfondo è determinato dal colore di sfondo del riquadro dell'app.	Se il file contiene una copertina dell'album, la miniatura è la copertina dell'album. In caso contrario, l'anteprima è un'icona posta su uno sfondo di dimensioni appropriate.	Se il file contiene l'immagine dell'album, l'anteprima è l'immagine dell'album con le proporzioni originali del file. In caso contrario, la miniatura è un'icona.
Documento	La miniatura è un'icona su uno sfondo di dimensioni appropriate. Il colore di sfondo è determinato dal colore di sfondo del riquadro dell'app.	L'anteprima è un'icona su uno sfondo di dimensioni appropriate. Il colore di sfondo è determinato dal colore di sfondo del riquadro dell'app.	Anteprima del documento, se presente. In caso contrario, la miniatura è un'icona.
Cartella	Se nella cartella è presente un file immagine, viene usata l'anteprima dell'immagine. In caso contrario, non viene recuperata alcuna thumbnail.	Non viene recuperata alcuna immagine di anteprima.	La miniatura è l'icona della cartella.
Gruppo di file	Se nella cartella è presente un file immagine, viene usata l'anteprima dell'immagine. In caso contrario, non viene recuperata alcuna thumbnail.	Se c'è un file con la copertina dell'album tra i file del gruppo, la miniatura è la copertina dell'album. In caso contrario, non viene recuperata alcuna anteprima.	Se è presente un file con albumart tra i file del gruppo, l'anteprima è l'immagine dell'album e usa le proporzioni originali del file. In caso contrario, l'anteprima è un'icona che rappresenta un gruppo di file.

Argomenti correlati

• Enumerazione di ThumbnailMode
• Classe StorageItemThumbnail
• StorageFile Classe
• Esempio di anteprima di file e cartelle (GitHub)
• Visualizzazione elenco e griglia