Compartilhar via


Controle de anexos no Power Apps

Um controle que permite que os usuários baixem arquivos em seu dispositivo, bem como carreguem e excluam arquivos de uma lista criada usando o Microsoft Lists ou uma tabela do Microsoft Dataverse.

Description

Um controle Anexos permite que você abra, adicione e exclua arquivos de uma lista ou de uma tabela do Dataverse.

Limitações

O controle de anexo tem estas limitações:

  1. O controle de anexo só dá suporte a listas e tabelas do Dataverse como fontes de dados. Expressões que transformam essas fontes de dados em Tabelas, por exemplo, com a função ForAll , não têm suporte.

  2. A funcionalidade de upload e exclusão funciona somente dentro de um formulário. O controle Anexo aparece desabilitado quando estiver no modo Editar e não dentro de um formulário. Para salvar adições e exclusões de arquivo, o usuário do aplicativo deve salvar o formulário. Devido a essa limitação, o controle Anexo não está disponível na guia Inserir , mas aparece no formulário quando o campo formulário Anexo está habilitado em um formulário do SharePoint ou do Dataverse.

  3. O controle anexos em um navegador da Web permite selecionar vários arquivos e permite o uso da funcionalidade de arrastar e soltar. No entanto, ao usar o controle de anexos no Power Apps Mobile, você só pode adicionar arquivos um de cada vez.

  4. Os arquivos armazenados no OneDrive ou em qualquer outro armazenamento em nuvem podem não estar anexados corretamente. Tente baixar esses arquivos no dispositivo antes de anexá-los usando o seletor de arquivos do dispositivo.

  5. O aplicativo móvel do Power Apps não dá suporte à captura de vídeos diretamente da câmera ou à seleção de vídeos da biblioteca de fotos ao usar o controle Anexos . Para adicionar um vídeo, os usuários devem usar a opção Procurar .

    • No Android: a opção Procurar exibe todos os tipos de arquivo, incluindo vídeos, permitindo que você selecione e anexe seus arquivos de vídeo.
    • No iOS: a opção Procurar mostra apenas os arquivos armazenados no aplicativo Arquivos. Se o vídeo ainda não estiver salvo lá, você precisará movê-lo para o aplicativo Arquivos antes de anexá-lo.

    Se um vídeo não aparecer como uma opção para anexar, primeiro salve o vídeo no aplicativo Arquivos do dispositivo e tente novamente.

Principais propriedades

Itens – a coluna Anexo da lista ou tabela do Dataverse. Não há suporte para coleções e tabelas.

MaxAttachments – O número máximo de arquivos que o controle aceitará.

MaxAttachmentSize – o tamanho máximo permitido do arquivo em MB de cada novo anexo. 1 MB aqui é 1.000.000 bytes (106 B) ou 1.000 KB.

OnAddFile – Ações a serem executadas quando o usuário adiciona um novo anexo de arquivo.

OnRemoveFile – Ações a serem executadas quando o usuário excluir um anexo existente.

OnUndoRemoveFile – Ações a serem executadas quando o usuário restaura um anexo excluído.

Propriedades adicionais

AccessibleLabel – Rótulo para leitores de tela. Deve descrever a finalidade dos anexos.

AddAttachmentText – O texto do rótulo do link usado para adicionar um novo anexo.

BorderColor – A cor da borda de um controle.

BorderStyle – se a borda de um controle é Solid, Dashed, Dotted ou None.

BorderThickness – A espessura da borda de um controle.

Cor – a cor do texto de um controle.

DisabledBorderColor – A cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitada.

DisabledColor – A cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitada.

DisabledFill – A cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitada.

DisplayMode – se o controle permite adicionar e excluir arquivos (Editar), exibe apenas dados (Exibição) ou está desabilitado (desabilitado).

[DropTargetBackgroundColor] – A cor do plano de fundo de destino de soltar do controle.

[DropTargetBorderColor] – A cor da borda de destino de soltar do controle.

[DropTargetBorderStyle] – se a borda de destino de soltar do controle é Solid, Dashed, Dotted ou None.

[DropTargetBorderThickness] – A espessura da borda de destino de soltar do controle.

[DropTargetTextColor] – A cor do texto de destino de soltar do controle.

Fill – a cor da tela de fundo de um controle.

FocusedBorderColor – A cor da borda de um controle quando o controle está focado.

FocusedBorderThickness – A espessura da borda de um controle quando o controle está focado.

Altura – a distância entre as bordas superior e inferior de um controle.

Fonte – o nome da família de fontes em que o texto é exibido.

FontWeight – O peso do texto em um controle: Negrito, Semiaberto, Normal ou Mais Leve.

HoverBorderColor – A cor da borda de um controle quando o usuário mantém o ponteiro do mouse nesse controle.

HoverColor – A cor do texto em um controle quando o usuário mantém o ponteiro do mouse sobre ele.

HoverFill – A cor da tela de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.

Itálico – se o texto em um controle é itálico.

MaxAttachmentsText – O texto que substitui o link "Anexar arquivo" quando o controle contém o número máximo de arquivos permitidos.

NoAttachmentsText – Texto informativo mostrado ao usuário quando não há arquivos anexados.

Preenchimento – a distância entre o texto em um botão de importação ou exportação e as bordas desse botão.

PressedBorderColor – A cor da borda de um controle quando o usuário seleciona esse controle.

PressedColor – A cor do texto em um controle quando o usuário seleciona esse controle.

PressedFill – A cor da tela de fundo de um controle quando o usuário seleciona esse controle.

Redefinir – reverte todas as alterações no controle de anexos retornando ao estado salvo anteriormente.

Tamanho – o tamanho da fonte do texto que aparece em um controle.

Tachado – se uma linha aparece por meio do texto que aparece em um controle.

TabIndex – Ordem de navegação do teclado em relação a outros controles.

Dica de ferramenta – texto explicativo exibido quando o usuário passa o mouse sobre um controle.

Sublinhado – se uma linha aparece sob o texto que aparece em um controle.

Visível – se um controle está visível ou oculto.

Largura – a distância entre as bordas esquerda e direita de um controle.

X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (ou tela, se nenhum contêiner pai).

Y – A distância entre a borda superior de um controle e a borda superior do contêiner pai (ou tela, se nenhum contêiner pai).

Example

  1. Adicione um formulário ao seu aplicativo e defina uma lista como sua fonte de dados.

  2. Selecione o controle Formulário de Exibição no modo de exibição de árvore no lado esquerdo. Você também pode usar Editar Formulário .

  3. Selecione Fonte de Dados na guia Propriedades no painel de opções à direita e selecione a lista à qual você se conectou.

  4. Selecione Editar campos na seção Campos e selecione Adicionar campo.

  5. Selecione o campo Anexos e selecione Adicionar.

    O campo Anexos associado à lista será exibido no formulário.

Saiba como adicionar e configurar um controle

Diretrizes de acessibilidade

Contraste de cores

Deve haver contraste de cores adequado entre:

  • ItemColor e ItemFill
  • ItemHoverColor e ItemHoverFill
  • ItemPressedColor e ItemPressedFill
  • AddedItemColor e AddedItemFill
  • RemovedItemColor e RemovedItemFill
  • ItemErrorColor e ItemErrorFill
  • AddAttachmentColor e Fill
  • MaxAttachmentsColor e Fill
  • NoAttachmentsColor e Fill

Esse requisito é além dos requisitos de contraste de cores padrão.

Suporte ao leitor de tela

As seguintes propriedades devem estar presentes:

Suporte ao teclado