Controlo Anexos no Power Apps

  • Artigo

Um controlo que permite aos utilizadores transferirem ficheiros para o dispositivo, bem como carregar e eliminar ficheiros de uma lista criada utilizando Listas Microsoft ou uma tabela do Microsoft Dataverse.

Descrição

Um controlo Anexos permite-lhe abrir, adicionar e eliminar ficheiros de uma lista ou de uma tabela do Dataverse.

Limitações

O controlo Anexos tem as seguintes limitações:

  1. O controlo Anexos só suporta listas e tabelas do Dataverse como as origens de dados. Expressões que transformam estas origens de dados em Tabelas, por exemplo, com a função ForAll, não são suportadas.

  2. A funcionalidade de carregamento e eliminação funcionam apenas dentro de um formulário. O controlo Anexos aparece desativado no modo de Edição, mas não dentro de um formulário. Para guardar as adições e exclusões de ficheiros, o utilizador da aplicação tem de guardar o formulário. Por causa desta limitação, o controlo Anexos não está disponível no separador Inserir, mas aparece no formulário quando o campo formulário Anexar está ativado num formulário SharePoint ou Dataverse.

  3. O Controlo Anexos num browser Web permite selecionar vários ficheiros e permite o uso da funcionalidade de arrastar e largar. No entanto, ao utilizar o controlo Anexos no Power Apps Mobile, só é possível adicionar ficheiros um de cada vez.

Propriedades principais

Items – A coluna Anexo da lista ou tabela do Dataverse. Coleções e Tabelas não são suportadas.

MaxAttachments – o número máximo de ficheiros que o controlo irá aceitar.

MaxAttachmentSize – o tamanho máximo de ficheiro permitido em MB de cada novo anexo. 1 MB é 1 000 000 bytes (106 B) ou 1000 KB.

OnAddFile – Ações a executar quando o utilizador adiciona um novo anexo de ficheiro.

OnRemoveFile – Ações a executar quando o utilizador elimina um anexo existente.

OnUndoRemoveFile – Ações a executar quando o utilizador restaura um anexo eliminado.

Propriedades adicionais

AccessibleLabel – a etiqueta para os leitores de ecrãs. Deve descrever a finalidade dos anexos.

AddAttachmentText – o texto da etiqueta da ligação utilizada para adicionar um novo anexo.

BorderColor – a cor do limite de um controlo.

BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.

BorderThickness – a espessura do limite de um controlo.

Color – a cor do texto de um controlo.

DisabledBorderColor – a cor do limite de um controlo se a propriedade DisplayMode do controlo estiver definida como Desativada.

DisabledColor – a cor do texto num controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.

DisabledFill – a cor de fundo de um controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.

DisplayMode – se o controlo permite adicionar e eliminar ficheiros (Editar), se apenas apresenta dados (Ver) ou se está desativado (Desativado).

[DropTargetBackgroundColor]– A cor do fundo do alvo de queda do controlo.

[DropTargetBorderColor]– A cor da margem do alvo de queda do controlo.

[DropTargetBorderStyle] – Indica se o limite de um controlo é Sólido, Tracejado, Pontilhado ou Nenhum.

[DropTargetBorderThickness]– A espessura da margem do alvo de queda do controlo.

[DropTargetTextColor]– A cor do texto do alvo de queda do controlo.

Fill – a cor de fundo de um controlo.

FocusedBorderColor – a cor do limite de um controlo quando o controlo é destacado.

FocusedBorderThickness – a espessura do limite de um controlo quando o controlo é destacado.

Height – a distância entre as margens superiores e inferiores de um controlo.

Font – o nome da família dos tipos de letra que aparecem no texto.

FontWeight – a espessura do texto num controlo: Negrito, Seminegrito, Normal ou Mais leve.

HoverBorderColor – a cor do limite de um controlo quando o utilizador mantém o ponteiro do rato nesse controlo.

HoverColor – a cor do texto num controlo quando o utilizador mantém o ponteiro do rato no mesmo.

HoverFill – a cor de fundo de um controlo quando o utilizador mantém o ponteiro do rato no mesmo.

Italic – se o texto num controlo estiver em itálico.

MaxAttachmentsText – o texto que substitui a ligação "Anexar ficheiro" quando o controlo contém o número máximo de ficheiros permitido.

NoAttachmentsText – texto informativo apresentado ao utilizador quando não existem ficheiros anexados.

Padding – a distância entre o texto num botão de importação ou exportação e as margens desse botão.

PressedBorderColor – a cor do limite de um controlo quando o utilizador seleciona esse controlo.

PressedColor – a cor do texto num controlo quando o utilizador seleciona esse controlo.

PressedFill – a cor de fundo de um controlo quando o utilizador seleciona esse controlo.

Reset – Reverte todas as alterações ao Controlo Anexos ao voltar ao estado guardado anteriormente.

Size – o tamanho do tipo de letra do texto que é apresentado num controlo.

Strikethrough – se é apresentada uma linha no meio do texto que aparece num controlo.

TabIndex – a ordem de navegação no teclado em relação a outros controlos.

Tooltip – o texto explicativo que aparece quando o rato passa por cima de um controlo.

Underline – se é apresentada uma linha sob o texto que aparece num controlo.

Visible – se um controlo está visível ou oculto.

Width – a distância entre as margens esquerda e direita de um controlo.

X – a distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo recipiente principal (ou ecrã, se não existir um recipiente principal).

Y – a distância entre o limite superior de um controlo e o limite superior do recipiente principal (ou ecrã, se não existir um recipiente principal).

Exemplo

  1. Adicione um formulário à sua aplicação e defina uma lista como a respetiva origem de dados.

  2. Selecione o controlo Apresentar formulário na vista de árvore no lado esquerdo. Também pode utilizar Editar formulário.

  3. Selecione Origem de Dados no separador Propriedades no painel Opções à direita e, em seguida, selecione a lista à qual se ligou.

  4. Selecione editar campos na secção Campos e selecione Adicionar campo.

  5. Selecione o campo Anexos e, em seguida, selecione Adicionar.

    O campo Anexos associado à lista aparecerá no formulário.

Saiba como adicionar e configurar um controlo

Diretrizes de acessibilidade

Contraste de cor

Tem de existir contraste de cor 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

Este requisito é uma adição aos requisitos de contraste de cor padrão.

Suporte a leitor de ecrã

As seguintes propriedades têm de estar presentes:

Suporte de teclado

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).