Imágenes en miniatura

Estas instrucciones describen cómo usar imágenes en miniatura para ayudar a los usuarios a obtener una vista previa de los archivos a medida que exploran la aplicación WinUI.

Las APIs importantes

• ThumbnailMode

¿Mi aplicación debe incluir miniaturas?

Si la aplicación permite a los usuarios examinar archivos, puede mostrar imágenes en miniatura para ayudar a los usuarios a obtener una vista previa rápida de esos archivos.

Use miniaturas cuando:

• Mostrar vistas previas para muchos elementos de una colección de galería (como archivos y carpetas). Por ejemplo, una galería de fotos debe usar miniaturas para proporcionar a los usuarios una vista pequeña de cada imagen a medida que navegan por sus archivos de fotos.

  

• Mostrar una vista previa de un elemento individual en una lista (como un archivo específico). Por ejemplo, es posible que el usuario quiera ver más información sobre un archivo, incluida una miniatura más grande para obtener una vista previa mejor, antes de decidir si desea abrir el archivo.

  

Qué hacer y qué no hacer

• Especifique el modo de miniatura (PicturesView, VideosView, DocumentsView, MusicView, ListView o SingleItem) al recuperar miniaturas. Esto garantiza que las imágenes en miniatura estén optimizadas para mostrar el tipo de archivos que los usuarios quieren ver.

  • Use el modo SingleItem para recuperar una miniatura de un solo elemento, independientemente del tipo de archivo. Los otros modos de miniatura están diseñados para mostrar vistas previas de varios archivos.

• Mostrar imágenes genéricas de marcador de posición en lugar de miniaturas mientras se cargan las miniaturas. El uso de marcadores de posición ayuda a la aplicación a parecer más dinámico porque los usuarios pueden interactuar con vistas previas antes de la carga de miniaturas.

  Las imágenes de marcador de posición deben ser:

  • Específico del tipo de elemento que representa. Por ejemplo, las carpetas, las imágenes y los vídeos deben tener sus propios marcadores de posición especializados.
  • El mismo tamaño y relación de aspecto que la imagen en miniatura que representa.
  • Se muestra hasta que se carga la imagen en miniatura.

• Use imágenes de marcador de posición con etiquetas de texto para representar carpetas y grupos de archivos para diferenciar entre archivos individuales.

• Si no puede recuperar una miniatura, muestre una imagen genérica.

• Muestra información adicional sobre archivos al proporcionar vistas previas para archivos de documentos y música. A continuación, los usuarios pueden identificar información clave sobre un archivo que podría no estar disponible fácilmente desde una imagen en miniatura. Por ejemplo, para un archivo de música, puede mostrar el nombre del artista junto con la miniatura del arte del álbum.

• No muestre información adicional de archivo para archivos de imagen y vídeo. En la mayoría de los casos, una imagen en miniatura es suficiente para los usuarios que exploran imágenes y vídeos.

Directrices de uso adicionales

Modos de miniatura recomendados y sus características:

Visualización de vistas previas para	Modos de miniatura	Características de las imágenes en miniatura recuperadas
Fotos Vídeos	PicturesView VídeosView	Tamaño: Medio, preferiblemente al menos 190 (si el tamaño de la imagen es 190x130) Relación de aspecto: Relación de aspecto uniforme y ancha de aproximadamente 0,7 (190x130 si el tamaño es 190) Recortado para previsualizaciones. Adecuado para alinear imágenes en una cuadrícula debido a una relación de aspecto uniforme.
Documents Música	VisorDeDocumentos MusicView ListView	Tamaño: Pequeño, preferiblemente al menos 40 x 40 píxeles Relación de aspecto: Cuadrada y uniforme Bueno para previsualizar la portada del álbum debido al formato cuadrado. Los documentos tienen el mismo aspecto que en una ventana del selector de archivos (usa los mismos iconos).
Cualquier elemento único (independientemente del tipo de archivo)	SingleItem	Tamaño: Pequeño, preferiblemente al menos 40 x 40 píxeles Relación de aspecto: Cuadrada y uniforme Bueno para previsualizar la portada del álbum debido al formato cuadrado. Los documentos tienen el mismo aspecto que en una ventana del selector de archivos (usa los mismos iconos).

Estos son ejemplos que muestran cómo difieren las imágenes en miniatura recuperadas en función del tipo de archivo y el modo de miniatura:

Tipo de elemento	Cuando se recupera mediante: PicturesView VideosView	Cuando se recupera mediante: VisorDeDocumentos MusicView ListView	Cuando se recupera mediante: ElementoÚnico
Imagen	La imagen en miniatura usa una relación de aspecto uniforme y ancha de aproximadamente 7 (190 x 130 si el tamaño preferido es 190).	La miniatura se recorta a una proporción cuadrada.	La imagen en miniatura usa la relación de aspecto original del archivo.
Vídeo	La miniatura tiene un icono que lo diferencia de las imágenes.	La miniatura se recorta en formato cuadrado.	La imagen en miniatura utiliza la proporción de aspecto original del archivo.
Música	La miniatura es un icono en un fondo de tamaño adecuado. El color de fondo viene determinado por el color de fondo del icono de la aplicación.	Si el archivo tiene arte de álbum, la miniatura es el arte del álbum. De lo contrario, la miniatura es un icono en un fondo de tamaño adecuado.	Si el archivo tiene arte de álbum, la miniatura es la imagen del álbum con la relación de aspecto original del archivo. De lo contrario, la miniatura es un icono.
Documento	La miniatura es un icono en un fondo de tamaño adecuado. El color de fondo viene determinado por el color de fondo del icono de la aplicación.	La miniatura es un icono en un fondo de tamaño adecuado. El color de fondo viene determinado por el color de fondo del icono de la aplicación.	Miniatura del documento, si existe una. De lo contrario, la miniatura es un icono.
Folder	Si hay un archivo de imagen en la carpeta, se usará la miniatura de imagen. De lo contrario, no se recupera ninguna miniatura.	No se recupera ninguna imagen en miniatura.	La miniatura es el icono de carpeta.
Grupo de archivos	Si hay un archivo de imagen en la carpeta, se usará la miniatura de imagen. De lo contrario, no se recupera ninguna miniatura.	Si hay un archivo que tiene una imagen de álbum entre los archivos del grupo, la miniatura es el arte del álbum. De lo contrario, no se recupera ninguna miniatura.	Si hay un archivo que tiene una imagen de álbum entre los archivos del grupo, la miniatura es la imagen del álbum y usa la relación de aspecto original del archivo. De lo contrario, la miniatura es un icono que representa un grupo de archivos.

Temas relacionados

• Enumeración ModoMiniatura
• Clase StorageItemThumbnail
• Clase StorageFile
• Ejemplo de miniatura de archivos y carpetas (GitHub)
• Vista de lista y cuadrícula