Miniatyrbilder

De här riktlinjerna beskriver hur du använder miniatyrbilder för att hjälpa användare att förhandsgranska filer när de bläddrar i din WinUI-app.

viktiga API:er

• Miniatyrbildsläge

Ska min app innehålla miniatyrbilder?

Om appen tillåter användare att bläddra bland filer kan du visa miniatyrbilder så att användarna snabbt kan förhandsgranska filerna.

Använd miniatyrbilder när:

• Visa förhandsgranskningar för många objekt i en gallerisamling (till exempel filer och mappar). Ett fotogalleri bör till exempel använda miniatyrbilder för att ge användarna en liten vy över varje bild när de bläddrar igenom sina fotofiler.

  

• Visa en förhandsgranskning för ett enskilt objekt i en lista (till exempel en specifik fil). Användaren kanske till exempel vill se mer information om en fil, inklusive en större miniatyrbild för en bättre förhandsversion, innan han eller hon bestämmer sig för att öppna filen.

  

Saker man ska och inte ska göra

• Ange miniatyrläget (PicturesView, VideosView, DocumentsView, MusicView, ListView eller SingleItem) när du hämtar miniatyrbilder. Detta säkerställer att miniatyrbilder optimeras för att visa vilken typ av filer användarna vill se.

  • Använd SingleItem-läget för att hämta en miniatyrbild för ett enskilt objekt, oavsett filtyp. De andra miniatyrlägena är avsedda att visa förhandsgranskningar av flera filer.

• Visa allmänna platshållarbilder i stället för miniatyrbilder under tiden miniatyrbilderna läses in. Med platshållare kan din app verka mer dynamisk eftersom användarna kan interagera med förhandsversioner innan miniatyrbilden läses in.

  Platshållarbilder ska vara:

  • Specifikt för den typ av objekt som det representerar. Till exempel bör mappar, bilder och videor alla ha sina egna specialiserade platshållare.
  • Samma storlek och proportion som miniatyrbilden den står för.
  • Visas till dess att miniatyrbilden har lästs in.

• Använd platshållarbilder med textetiketter för att representera mappar och filgrupper för att skilja från enskilda filer.

• Om du inte kan hämta en miniatyrbild visar du en platshållarbild.

• Visa ytterligare filinformation när du tillhandahåller förhandsgranskningar för dokument- och musikfiler. Användarna kan sedan identifiera viktig information om en fil som kanske inte är tillgänglig enbart från en miniatyrbild. För en musikfil kan du till exempel visa namnet på artisten tillsammans med miniatyrbilden av albumbilden.

• Visa inte ytterligare filinformation för bild- och videofiler. I de flesta fall räcker det med en miniatyrbild för användare som bläddrar igenom bilder och videor.

Ytterligare användningsriktlinjer

Rekommenderade miniatyrlägen och deras funktioner:

Visa förhandsgranskningar för	Miniatyrlägen	Funktioner hos de hämtade miniatyrbilderna
Pictures Videor	BilderVy Videovisning	Storlek: Medel, helst minst 190 (om bildstorleken är 190x130) Bildförhållande: Enhetligt, brett bildförhållande på cirka 0.7 (190x130 om dimensionerna är 190) Beskuren för förhandsversioner. Bra för att justera bilder i ett rutnät på grund av enhetliga proportioner.
Documents Musik	Dokumentvy MusicView ListVy	Storlek: Liten, helst minst 40 x 40 bildpunkter Bildförhållande: Enhetlig, kvadratisk Bra för att förhandsgranska albumomslag tack vare sitt kvadratiska format. Dokument ser likadana ut som de ser ut i ett filväljarefönster (de använder samma ikoner).
Valfritt enskilt objekt (oavsett filtyp)	SingleItem	Storlek: Liten, helst minst 40 x 40 bildpunkter Bildförhållande: Enhetlig, kvadratisk Bra för att förhandsgranska albumomslag tack vare sitt kvadratiska format. Dokument ser likadana ut som de ser ut i ett filväljarefönster (de använder samma ikoner).

Här är exempel som visar hur hämtade miniatyrbilder skiljer sig åt beroende på filtyp och miniatyrläge:

Objekttyp	När den hämtas med hjälp av: BilderVy Videosvy	När den hämtas med hjälp av: Dokumentvy MusicView ListVy	När det hämtas med hjälp av: SingleItem
Bild	Miniatyrbilden använder en bred, enhetlig bildförhållande på cirka 0,7 (190 x 130 om den föredragna storleken är 190).	Miniatyrbilden beskärs till ett kvadratformat.	Miniatyrbilden använder de ursprungliga proportionerna i filen.
Video	Miniatyrbilden har en ikon som skiljer den från bilder.	Miniatyrbilden beskärs till ett kvadratformat.	Miniatyrbilden använder de ursprungliga proportionerna i filen.
Musik	Miniatyrbilden är en ikon i en bakgrund med lämplig storlek. Bakgrundsfärgen bestäms av appens panelbakgrundsfärg.	Om filen har albumkonst är miniatyrbilden albumbilden. Annars är miniatyrbilden en ikon i en bakgrund med lämplig storlek.	Om filen har albumomslag blir miniatyrbilden albumomslaget med filens ursprungliga proportioner. Annars är miniatyrbilden en ikon.
Dokument	Miniatyrbilden är en ikon i en bakgrund med lämplig storlek. Bakgrundsfärgen bestäms av appens panelbakgrundsfärg.	Miniatyrbilden är en ikon i en bakgrund med lämplig storlek. Bakgrundsfärgen bestäms av appens panelbakgrundsfärg.	Dokumentminiatyren, om det finns en sådan. Annars är miniatyrbilden en ikon.
Folder	Om det finns en bildfil i mappen används miniatyrbilden. Annars hämtas ingen miniatyrbild.	Ingen miniatyrbild blir hämtad.	Miniatyrbilden är mappikonen.
Filgrupp	Om det finns en bildfil i mappen används miniatyrbilden. Annars hämtas ingen miniatyrbild.	Om det finns en fil som har albumkonst bland filerna i gruppen är miniatyrbilden albumbilden. Annars hämtas ingen miniatyrbild.	Om det finns en fil som har albumkonst bland filerna i gruppen är miniatyrbilden albumkonsten och använder originalproportionerna för filen. Annars är miniatyrbilden en ikon som representerar en grupp filer.

Relaterade ämnen

• ThumbnailMode enum
• StorageItemThumbnail-klass
• StorageFile-klass
• Exempel på fil- och mappminiatyr (GitHub)
• List- och rutnätsläge