Windows Share DataFormat e referência de FileType

Use esta referência para escolher as declarações e APIs corretas DataFormat para a sua integração com o Windows Share.

Tabela de referência DataFormat

DataFormat Send API API de receção Tipos típicos de aplicações
Text SetText GetTextAsync Aplicações de notas, ferramentas de prancheta, texto geral
Uri / WebLink SetWebLink GetWebLinkAsync Navegadores, favoritos, aplicações de mensagens
ApplicationLink SetApplicationLink GetApplicationLinkAsync Aplicações que expõem ligações profundas
Html SetHtmlFormat GetHtmlFormatAsync Clientes de email, editores de texto enriquecido
Bitmap SetBitmap GetBitmapAsync Editores de fotos, visualizadores de imagens
StorageItems SetStorageItems GetStorageItemsAsync gestores de ficheiros, aplicações de armazenamento na nuvem
Rtf SetRtf GetRtfAsync Processadores de Word, editores de texto enriquecido

Tip

Para URLs, prefira SetWebLink sempre em vez de SetText. As aplicações de destino conseguem gerar pré-visualizações ricas de links e gerir a navegação corretamente apenas quando o conteúdo chega digitado como URI.

Declarações de FileType por categoria de aplicação

Use esta folha de dica para escolher o conjunto mais restrito de <uap:FileType> declarações para o seu manifesto. Declarar menos e mais específicos tipos reduz o ruído na Folha de Partilha e impede que a sua aplicação apareça para conteúdos que não consegue gerir.

Categoria da aplicação Declarações recomendadas <uap:FileType> Formatos de dados adicionais
Visualizador / editor de fotos .jpg .jpeg .png .gif .bmp .heic .webp Bitmap, StorageItems
Leitor de vídeo .mp4 .mov .avi .mkv .wmv StorageItems
Leitor de áudio .mp3 .flac .wav .aac .m4a StorageItems
Editor de documentos .pdf .docx .xlsx .pptx .txt StorageItems
Gestor de links / navegador (sem tipos de ficheiros) Uri, WebLink
Aplicação de mensagens (sem tipos de ficheiros, nem tipos específicos de anexos) Uri, WebLink, StorageItems
Aplicação de notas .txt .md Text, StorageItems
Armazenamento na nuvem / mover ficheiros <uap:SupportsAnyFileType /> StorageItems

Importante

<uap:SupportsAnyFileType /> é apropriado apenas para transportadores de ficheiros de uso geral. Para todas as outras categorias de aplicações, declara extensões de ficheiro específicas. Declarações excessivamente amplas são o bug de share-target mais comum.

Conteúdo relacionado

  • Last updated on