Imagens em miniatura

Essas diretrizes descrevem como usar imagens em miniatura para ajudar os usuários a visualizar arquivos enquanto navegam em seu aplicativo WinUI.

APIs importantes

• ThumbnailMode

Meu aplicativo deve incluir miniaturas?

Se o aplicativo permitir que os usuários procurem arquivos, você poderá exibir imagens em miniatura para ajudar os usuários a visualizar rapidamente esses arquivos.

Use miniaturas quando:

• Exibindo visualizações para muitos itens em uma coleção de galerias (como arquivos e pastas). Por exemplo, uma galeria de fotos deve usar miniaturas para dar aos usuários uma pequena exibição de cada imagem enquanto navegam pelos arquivos de fotos.

  

• Exibindo uma visualização de um item individual em uma lista (como um arquivo específico). Por exemplo, talvez o usuário queira ver mais informações sobre um arquivo, incluindo uma miniatura maior para uma melhor visualização, antes de decidir se deseja abrir o arquivo.

  

O que fazer e o que não fazer

• Especifique o modo de miniatura (PicturesView, VideosView, DocumentsView, MusicView, ListView ou SingleItem) quando recuperar miniaturas. Isso garante que as imagens em miniatura sejam otimizadas para exibir o tipo de arquivos que os usuários desejam ver.

  • Use o modo SingleItem para recuperar uma miniatura para um único item, independentemente do tipo de arquivo. Os outros modos de miniatura são destinados a exibir visualizações de vários arquivos.

• Exiba imagens de espaço reservado genéricas no lugar de miniaturas enquanto as miniaturas são carregadas. Usar espaços reservados ajuda seu aplicativo a parecer mais responsivo porque os usuários podem interagir com pré-visualizações antes do carregamento da miniatura.

  As imagens de espaço reservado devem ser:

  • Específico para o tipo de item que ele representa. Por exemplo, pastas, imagens e vídeos devem ter seus próprios espaços reservados especializados.
  • Tem o mesmo tamanho e proporção da imagem em miniatura que substitui.
  • Exibido até que a imagem em miniatura seja carregada.

• Use imagens de espaço reservado com rótulos de texto para representar pastas e grupos de arquivos para diferenciar arquivos individuais.

• Caso não seja possível recuperar uma miniatura, exiba uma imagem de espaço reservado.

• Exiba informações adicionais de arquivo ao fornecer visualizações para arquivos de documentos e músicas. Os usuários podem identificar informações importantes sobre um arquivo que pode não estar prontamente disponível apenas em uma imagem em miniatura. Por exemplo, para um arquivo de música, você pode exibir o nome do artista junto com a miniatura da arte do álbum.

• Não exiba informações adicionais de arquivo para arquivos de imagem e vídeo. Na maioria dos casos, uma imagem em miniatura é suficiente para usuários que navegam por imagens e vídeos.

Diretrizes de uso adicionais

Modos de miniatura recomendados e seus recursos:

Aqui estão exemplos que mostram como as imagens em miniatura recuperadas diferem dependendo do tipo de arquivo e do modo de miniatura:

Tipo de item	Quando recuperado usando: PicturesView Visualização de Vídeos	Quando recuperado usando: VisualizaçãoDeDocumentos MusicView ListView	Quando recuperado usando: Item Único
Imagem	A imagem em miniatura usa uma proporção uniforme e ampla de cerca de 0,7 (190 x 130 se o tamanho preferencial for 190).	A miniatura é cortada para uma proporção quadrada.	A imagem em miniatura usa a proporção original do arquivo.
Vídeo	A miniatura tem um ícone que a diferencia das imagens.	A miniatura é cortada para uma relação de aspecto quadrada.	A imagem em miniatura usa a proporção original do arquivo.
Música	A miniatura é um ícone em uma tela de fundo de tamanho apropriado. A cor de fundo é determinada pela cor de fundo do tile do aplicativo.	Se o arquivo tem arte do álbum, então a miniatura é a arte do álbum. Caso contrário, a miniatura será um ícone em uma tela de fundo de tamanho apropriado.	Se o arquivo tiver arte do álbum, a miniatura será a arte do álbum com a proporção original do arquivo. Caso contrário, a miniatura é um ícone.
Documento	A miniatura é um ícone em uma tela de fundo de tamanho apropriado. A cor da tela de fundo é determinada pela cor de fundo do azulejo do aplicativo.	A miniatura é um ícone em uma tela de fundo de tamanho apropriado. A cor de fundo é determinada pela cor de fundo do bloco do aplicativo.	A miniatura do documento, se existir. Caso contrário, a miniatura é um ícone.
Pasta	Se houver um arquivo de imagem na pasta, a miniatura da imagem será usada. Caso contrário, não será recuperada nenhuma miniatura.	Nenhuma imagem em miniatura é recuperada.	A miniatura é o ícone da pasta.
Grupo de arquivos	Se houver um arquivo de imagem na pasta, a miniatura da imagem será usada. Caso contrário, nenhuma miniatura será recuperada.	Se houver um arquivo que tenha arte de álbum entre os arquivos do grupo, a miniatura será a arte do álbum. Caso contrário, nenhuma miniatura será obtida.	Se houver um arquivo que contenha a arte do álbum entre os arquivos do grupo, a miniatura será a arte do álbum e usará a proporção original do arquivo. Exibir miniaturas de grupo de arquivos no modo documentos, música ou lista usando a proporção de aspecto original do arquivo. Caso contrário, a miniatura é um ícone que representa um grupo de arquivos.

Tópicos relacionados

• Enumeração ThumbnailMode
• Classe StorageItemThumbnail
• Classe StorageFile
• Exemplo de miniatura de arquivo e pasta (GitHub)
• Exibição de lista e grade