Miniaturbilder

Diese Richtlinien beschreiben, wie Sie Miniaturansichten verwenden, um Benutzern die Vorschau von Dateien während der Navigation in Ihrer WinUI-App zu erleichtern.

Wichtige APIs

• ThumbnailMode

Sollte meine App Miniaturansichten enthalten?

Wenn Ihre App Benutzern das Durchsuchen von Dateien ermöglicht, können Sie Miniaturansichten anzeigen, damit Benutzer schnell eine Vorschau dieser Dateien anzeigen können.

Verwenden Sie Miniaturansichten, wenn:

• Anzeigen von Vorschauen für viele Elemente in einer Katalogsammlung (z. B. Dateien und Ordner). Beispielsweise sollte eine Fotogalerie Miniaturansichten verwenden, um Benutzern eine kleine Ansicht der einzelnen Bilder zu geben, während sie durch ihre Fotodateien navigieren.

  

• Anzeigen einer Vorschau für ein einzelnes Element in einer Liste (z. B. eine bestimmte Datei). Beispielsweise möchte der Benutzer weitere Informationen zu einer Datei sehen, einschließlich einer größeren Miniaturansicht für eine bessere Vorschau, bevor er entscheidet, ob die Datei geöffnet werden soll.

  

Gebote und Verbote

• Geben Sie den Miniaturansichtsmodus (PicturesView, VideosView, DocumentsView, MusicView, ListView oder SingleItem) an, wenn Sie Miniaturansichten abrufen. Dadurch wird sichergestellt, dass Miniaturansichten optimiert sind, um den Typ der Dateien anzuzeigen, die Benutzer sehen möchten.

  • Verwenden Sie den SingleItem-Modus, um unabhängig vom Dateityp eine Miniaturansicht für ein einzelnes Element abzurufen. Die anderen Miniaturansichtsmodi sollen Vorschauen mehrerer Dateien anzeigen.

• Zeige anstelle von Miniaturbildern generische Platzhalterbilder an, während die Miniaturbilder geladen werden. Die Verwendung von Platzhaltern hilft Ihrer App, reaktionsfähiger zu erscheinen, da Benutzer vor dem Laden der Miniaturansicht mit Vorschauen interagieren können.

  Platzhalterbilder sollten folgendes sein:

  • Spezifisch für die Art des Elements, für das es steht. Beispielsweise sollten Ordner, Bilder und Videos über eigene spezielle Platzhalter verfügen.
  • Sie sollten die gleiche Größe und das gleiche Seitenverhältnis wie das Miniaturbild aufweisen, das sie darstellen.
  • Wird angezeigt, bis das Miniaturansichtsbild geladen wird.

• Verwenden Sie Platzhalterbilder mit Textbeschriftungen, um Ordner und Dateigruppen darzustellen, um von einzelnen Dateien zu unterscheiden.

• Wenn Sie keine Miniaturansicht abrufen können, zeigen Sie ein Platzhalterbild an.

• Zeigen Sie zusätzliche Dateiinformationen an, wenn Sie Eine Vorschau für Dokument- und Musikdateien bereitstellen. Benutzer können dann wichtige Informationen zu einer Datei identifizieren, die möglicherweise nicht einfach aus einem Miniaturbild verfügbar ist. Bei einer Musikdatei können Sie z. B. den Namen des Künstlers zusammen mit der Miniaturansicht des Albumbilds anzeigen.

• Zeigen Sie keine zusätzlichen Dateiinformationen für Bild- und Videodateien an. In den meisten Fällen reicht ein Miniaturbild aus, damit Benutzer Bilder und Videos durchsuchen können.

Zusätzliche Nutzungsrichtlinien

Empfohlene Miniaturansichtsmodi und deren Features:

Vorschauen anzeigen für	Miniaturansichtsmodi	Merkmale der abgerufenen Miniaturansichten
Bilder Videos	PicturesView VideosView	Größe: Mittel, vorzugsweise mindestens 190 (wenn die Bildgröße 190 x 130 beträgt) Seitenverhältnis: Einheitliches, breites Seitenverhältnis von ca. .7 (190x130, wenn die Größe 190 ist) Zugeschnitten für Vorschauen. Geeignet zum Ausrichten von Bildern in einem Raster aufgrund eines einheitlichen Seitenverhältnisses.
Dokumente Musik	DocumentsView MusicView ListView	Größe: Klein, vorzugsweise mindestens 40 x 40 Pixel Seitenverhältnis: Einheitliches quadratisches Seitenverhältnis Gut für die Vorschau von Albumgrafiken aufgrund des quadratischen Seitenverhältnisses. Dokumente sehen wie in einem Dateiauswahlfenster aus (es werden dieselben Symbole verwendet).
Jedes einzelne Element (unabhängig vom Dateityp)	Einzelposten	Größe: Klein, vorzugsweise mindestens 40 x 40 Pixel Seitenverhältnis: Einheitliches quadratisches Seitenverhältnis Gut für die Vorschau von Albumgrafiken aufgrund des quadratischen Seitenverhältnisses. Dokumente sehen wie in einem Dateiauswahlfenster aus (es werden dieselben Symbole verwendet).

Hier sind Beispiele, die zeigen, wie sich abgerufene Miniaturansichten je nach Dateityp und Miniaturansichtsmodus unterscheiden:

Elementtyp	Beim Abrufen mit: PicturesView VideosView	Beim Abrufen mit: DocumentsView MusicView ListView	Beim Abrufen mit: Einzelartikel
Bild	Das Miniaturbild verwendet ein einheitliches, breites Seitenverhältnis von etwa 0,7 (190 x 130, wenn die bevorzugte Größe 190 ist).	Das Miniaturbild wird auf das quadratische Seitenverhältnis zugeschnitten.	Die Miniaturansicht verwendet das ursprüngliche Seitenverhältnis der Datei.
Video	Die Miniaturansicht weist ein Symbol auf, das es von Bildern unterscheidet.	Das Miniaturbild wird auf das quadratische Seitenverhältnis zugeschnitten.	Die Miniaturansicht verwendet das ursprüngliche Seitenverhältnis der Datei.
Musik	Beim Miniaturbild handelt es sich um ein Symbol vor einem Hintergrund entsprechender Größe. Die Hintergrundfarbe wird durch die Hintergrundfarbe der App-Kachel bestimmt.	Wenn die Datei über ein Albumcover verfügt, ist die Miniaturansicht das Albumcover. Andernfalls ist der Thumbnail ein Symbol auf einem Hintergrund der passenden Größe.	Wenn die Datei über eine Albumgrafik verfügt, ist die Miniaturansicht die Albumgrafik mit dem ursprünglichen Seitenverhältnis der Datei. Andernfalls ist das Thumbnail ein Symbol.
Dokument	Beim Miniaturbild handelt es sich um ein Symbol vor einem Hintergrund entsprechender Größe. Die Hintergrundfarbe wird durch die Hintergrundfarbe der App-Kachel bestimmt.	Beim Miniaturbild handelt es sich um ein Symbol vor einem Hintergrund entsprechender Größe. Die Hintergrundfarbe wird durch die Hintergrundfarbe der App-Kachel bestimmt.	Die Dokumentminiaturansicht, sofern vorhanden. Andernfalls ist das Thumbnail ein Symbol.
Ordner	Wenn im Ordner eine Bilddatei vorhanden ist, wird die Miniaturansicht des Bilds verwendet. Andernfalls wird keine Miniaturansicht abgerufen.	Es konnte kein Miniaturbild abgerufen werden.	Die Miniaturansicht ist das Ordnersymbol.
Dateigruppe	Wenn im Ordner eine Bilddatei vorhanden ist, wird die Miniaturansicht des Bilds verwendet. Andernfalls wird keine Miniaturansicht abgerufen.	Wenn die Dateigruppe eine Datei mit einem Albumbild enthält, ist das Miniaturbild das Albumbild. Andernfalls wird keine Miniaturansicht abgerufen.	Wenn die Dateigruppe eine Datei mit einem Albumbild enthält, entspricht das Miniaturbild dem Albumbild, und das ursprüngliche Seitenverhältnis der Datei wird verwendet. Andernfalls ist die Miniaturansicht ein Symbol, das eine Gruppe von Dateien darstellt.

Zugehörige Themen

• ThumbnailMode-Enumeration
• StorageItemThumbnail-Klasse
• StorageFile-Klasse
• Beispiel für Datei- und Ordnerminiaturansicht (GitHub)
• Listen- und Rasteransicht