Controllo Allegati in Power Apps
Un controllo che consente agli utenti di scaricare file sul proprio dispositivo, nonché di caricare ed eliminare file da un elenco creato utilizzando Microsoft Lists o una tabella di Microsoft Dataverse.
Descrizione
Un controllo Allegati consente di aprire, aggiungere ed eliminare file da un elenco o da una tabella Dataverse.
Limiti
Il controllo Allegato presente le seguenti limitazioni:
Il controllo Allegato supporta solo elenchi e tabelle Dataverse come origini dati. Le espressioni che trasformano queste origini dati in tabelle, ad esempio con la funzione ForAll, non sono supportate.
La funzionalità di caricamento e di eliminazione può essere usata solo all'interno di un modulo. Il controllo Allegato risulta disabilitato in modalità di modifica e all'esterno di un modulo. Per salvare le aggiunte e le eliminazioni di file, l'utente dell'app deve salvare il modulo. A causa di questa limitazione, il controllo Allegato non è disponibile nella scheda Inserisci ma appare nel modulo quando il campo del modulo Allegato è abilitato in un modulo SharePoint o Dataverse.
Il controllo Allegati su un browser Web consente di selezionare più file e di utilizzare la funzionalità di trascinamento della selezione. Tuttavia, quando si usa il controllo Allegati su Power Apps Mobile, puoi aggiungere solo un file alla volta.
Proprietà chiave
Items -La colonna Allegato dell'elenco o della tabella Dataverse. Raccolte e Tabelle non sono supportate.
MaxAttachments: numero massimo di file accettati dal controllo.
MaxAttachmentSize: dimensioni massime consentite per i file di ogni nuovo allegato in MB. 1 MB è 1.000.000 byte (106 B) o 1.000 KB.
OnAddFile - Azioni da eseguire quando l'utente aggiunge un nuovo allegato file.
OnRemoveFile - Azioni da eseguire quando l'utente elimina un allegato esistente.
OnUndoRemoveFile - Azioni da eseguire quando l'utente ripristina un allegato eliminato.
Proprietà aggiuntive
AccessibleLabel: etichetta per le utilità per la lettura dello schermo. Deve descrivere lo scopo degli allegati.
AddAttachmentText: testo dell'etichetta del collegamento usato per aggiungere un nuovo allegato.
BorderColor: colore del bordo di un controllo.
BorderStyle: indica se il bordo di un controllo è Solid (Tinta unita), Dashed (Tratteggiato), Dotted (Punteggiato) o None (Nessuno).
BorderThickness: spessore del bordo di un controllo.
Color: colore del testo di un controllo
DisabledBorderColor: colore del bordo di un controllo se la relativa proprietà DisplayMode è impostata su Disabled.
DisabledColor: colore del testo di un controllo se la relativa proprietà DisplayMode è impostata su Disabled.
DisabledFill: colore dello sfondo di un controllo se la relativa proprietà DisplayMode è impostata su Disabled.
DisplayMode: indica se il controllo consente l'aggiunta e l'eliminazione di file (Edit), visualizza solo i dati (View) o è disabilitato (Disabled).
[DropTargetBackgroundColor] – Il colore dello sfondo della destinazione di rilascio del controllo.
[DropTargetBorderColor] – Il colore del bordo della destinazione di rilascio del controllo.
[DropTargetBorderStyle] – Indica se il bordo di un controllo è a linea Solido, Tratteggiato, Punteggiato, o Nessuno.
[DropTargetBorderThickness] – Lo spessore del bordo della destinazione di rilascio del controllo.
[DropTargetTextColor] – Il colore del testo della destinazione di rilascio del controllo.
Fill: colore dello sfondo di un controllo.
FocusedBorderColor: colore del bordo di un controllo quando è evidenziato.
FocusedBorderThickness: spessore del bordo di un controllo quando è evidenziato.
Height: distanza tra i bordi superiore e inferiore del controllo.
Font: nome della famiglia di caratteri in cui viene visualizzato il testo.
FontWeight: spessore del testo di un controllo. Può essere Bold (Grassetto), Semibold (Semibold), Normal (Normale) o Lighter (Sottile).
HoverBorderColor: colore del bordo di un controllo quando l'utente posiziona il puntatore del mouse su di esso.
HoverColor: colore del testo di un controllo quando l'utente posiziona il puntatore del mouse su tale controllo.
HoverFill: colore dello sfondo di un controllo quando l'utente posiziona il puntatore del mouse su di esso.
Italic: indica se il testo di un controllo è in corsivo.
MaxAttachmentsText: testo che sostituisce il collegamento "Allega file" quando il controllo contiene il numero massimo di file consentiti.
NoAttachmentsText: testo informativo mostrato all'utente quando non sono presenti file allegati.
Padding: distanza tra il testo di un pulsante di importazione o esportazione e il bordo di tale pulsante.
PressedBorderColor: colore del bordo di un controllo quando l'utente lo seleziona.
PressedColor: colore del testo di un controllo quando l'utente lo seleziona.
PressedFill: colore dello sfondo di un controllo quando l'utente lo seleziona.
Reset - Ripristina lo stato salvato precedentemente di tutte le modifiche al controllo Allegati.
Size: dimensione del carattere del testo visualizzato in un controllo.
Strikethrough: indica se viene visualizzata una riga all'interno del testo di un controllo.
TabIndex: ordine di spostamento tramite tastiera in relazione ad altri controlli.
Tooltip: testo descrittivo visualizzato quando l'utente posiziona il mouse su un controllo.
Underline: indica se il testo visualizzato nel controllo è sottolineato.
Visible: indica se un controllo è visibile o nascosto.
Width: distanza tra i bordi sinistro e destro di un controllo.
X: distanza tra il bordo sinistro di un controllo e il bordo sinistro del contenitore padre o della schermata se non c'è un contenitore padre.
Y: distanza tra il bordo superiore di un controllo e il bordo superiore del contenitore padre o della schermata se non c'è un contenitore padre.
Esempio
Aggiungi un modulo all'app e imposta un elenco come origine dati.
Seleziona il controllo Modulo visualizzazione nella visualizzazione albero sul lato sinistro. Puoi anche usare Edit form.
Seleziona Data Source nella scheda Proprietà nel pannello delle opzioni a destra, quindi seleziona l'elenco a cui sei connesso.
Seleziona Modifica campi nella sezione Campi e seleziona Aggiungi campo.
Seleziona il campo Allegati, quindi Aggiungi.
Il campo Allegati associato all'elenco verrà visualizzato nel modulo.
Informazioni su come aggiungere e configurare un controllo
Linee guida per l'accessibilità
Contrasto dei colori
È necessario un contrasto dei colori adeguato tra:
- 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
Si tratta di un requisito aggiuntivo a quelli relativi al contrasto dei colori standard.
Supporto lettore schermo
Le proprietà seguenti devono essere presenti:
- AccessibleLabel
- AddAttachmentsText
- MaxAttachmentsText
- NoAttachmentsText
Supporto per la tastiera
- Il valore di TabIndex deve essere uguale o superiore a zero, in modo che gli utenti della tastiera possano passare a questo controllo.
- Gli indicatori di attivazione devono essere chiaramente visibili. A questo scopo, usare FocusedBorderColor e FocusedBorderThickness.
Nota
Puoi indicarci le tue preferenze di lingua per la documentazione? Partecipa a un breve sondaggio. (il sondaggio è in inglese)
Il sondaggio richiederà circa sette minuti. Non viene raccolto alcun dato personale (Informativa sulla privacy).