Controle Anexos no Power Apps
Um controle que permite aos usuários baixar arquivos nos seus dispositivos, bem como carregar e excluir arquivos de uma lista criada usando as Listas da Microsoft ou uma tabela do Microsoft Dataverse.
Descrição
Um controle Anexos permite abrir, adicionar e excluir arquivos de uma lista ou tabela do Dataverse.
Limitações
O controle attachment tem as seguintes limitações:
O controle attachment só oferece suporte a listas e tabelas do Dataverse como as fontes de dados. Expressões que transformam essas fontes de dados em tabelas, por exemplo, com a função ForAll, não são compatíveis.
As funcionalidades de upload e exclusão só funcionam dentro de um formulário. O controle Attachment aparece desabilitado no modo de edição, e não em um formulário. Para salvar adições e exclusões de arquivos, o usuário do aplicativo deve salvar o formulário. Devido a essa limitação, o controle Attachment não está disponível na guia Inserir, mas aparece no formulário quando o campo Formulário de anexo está ativado em um formulário do SharePoint ou do Dataverse.
O controle Anexos em um navegador da Web permite selecionar vários arquivos e permite usar a funcionalidade de arrastar e soltar. No entanto, ao usar o controle Anexos no Power Apps Mobile, você só pode adicionar um arquivo de cada vez.
Principais propriedades
Items – 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 de arquivo máximo permitido, em MB, de cada anexo novo. 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 exclui 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 do controle.
BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.
BorderThickness – a espessura da borda do controle.
Color – a cor do texto de um controle.
DisabledBorderColor – a cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitado.
DisabledColor – a cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitado.
DisabledFill – a cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitado.
DisplayMode – se o controle permite a adição e exclusão de arquivos (Editar), apenas exibe dados (Exibir) ou está desabilitado (Desabilitado).
[DropTargetBackgroundColor] – A cor de fundo do destino de soltar do controle.
[DropTargetBorderColor] – A cor da borda do destino de soltar do controle.
[DropTargetBorderStyle] – Se a borda do destino de soltar do controle é Sólida, Tracejada, Pontilhada ou Ausente.
[DropTargetBorderThickness] – A espessura da borda do destino de soltar do controle.
[DropTargetTextColor] – A cor do texto do destino de soltar do controle.
Fill – a cor da tela de fundo de um controle.
FocusedBorderColor – a cor da borda do controle quando ele está focalizado.
FocusedBorderThickness – A espessura da borda de um controle quando ele está focalizado.
Height – a distância entre a parte superior do controle e as bordas inferiores.
Font – o nome da família de fontes em que o texto é exibido.
FontWeight – o peso do texto em um controle: Negrito, Seminegrito, Normal ou Mais claro.
HoverBorderColor – a cor da borda do 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.
Italic – se o texto em um controle está em itálico.
MaxAttachmentsText – o texto que substitui o link "Anexar arquivo" quando o controle contém o número máximo de arquivos permitido.
NoAttachmentsText – texto informativo mostrado ao usuário quando não há arquivos anexados.
Padding – a distância entre o texto em um botão de importação ou exportação e as bordas do 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.
Reset - Reverte todas as alterações no controle Anexos, retornando ao estado salvo anteriormente.
Size – o tamanho da fonte do texto que aparece em um controle.
Strikethrough – se uma linha é exibida cortando o texto que aparece em um controle.
TabIndex – ordem de navegação do teclado em relação a outros controles.
Tooltip – texto explicativo exibido quando o usuário passa o mouse sobre um controle.
Underline – se uma linha é exibida sob o texto que aparece em um controle.
Visible – se um controle está visível ou oculto.
Width – 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 a tela, se não houver contêiner pai).
Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (ou a tela, se não houver contêiner pai).
Exemplo
Adicione um formulário ao seu aplicativo e defina uma lista como sua fonte de dados.
Selecione o controle Exibir formulário no modo de exibição de árvore no lado esquerdo. Como alternativa, você também pode usar Edit Form.
Selecione Fonte de dados na guia Propriedades no painel de opções à direita e, em seguida, selecione a opção lista à qual você se conectou.
Selecione Editar campos na seção Campos e, em seguida, Adicionar campo.
Selecione o campo Anexos e, depois, Adicionar.
O campo Anexos associado à lista será exibido no formulário.
Saiba como adicionar e configurar um controle
Diretrizes de acessibilidade
Contraste de cores
É necessário haver um 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
Essa é uma exigência além dos requisitos de contraste de cores padrão.
Suporte ao leitor de tela
As propriedades a seguir precisam estar presentes:
- AccessibleLabel
- AddAttachmentsText
- MaxAttachmentsText
- NoAttachmentsText
Suporte de teclado
- TabIndex deve ser zero ou maior para que os usuários de teclado possam navegar para ela.
- Os indicadores de foco precisam ser evidentes. Use FocusedBorderColor e FocusedBorderThickness para atingir esta clareza.
Observação
Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)
A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).