Controllo scheda in Power Apps

Fornisce l'esperienza di visualizzazione e modifica per un singolo campo di un modulo di visualizzazione o di un controllo Modifica modulo .

Description

I controlli Modulo di visualizzazione e Modifica modulo fungono da contenitori per la visualizzazione e la visualizzazione di interi record. Ogni contenitore può contenere un set di controlli Scheda che visualizzano singoli campi o consentono di aggiornare tali campi. Ogni scheda ha una proprietà DataField che specifica il campo del record su cui funziona.

Le schede predefinite sono definite per diversi tipi di dati ed esperienze utente. Ad esempio, potrebbe esserci una scheda per modificare un campo numerico con un controllo Input di testo , ideale per l'uso con la tastiera. Un'altra scheda potrebbe supportare la modifica di un numero usando invece un controllo Slider . Con il controllo modulo selezionato, è possibile, nel riquadro di destra, selezionare facilmente una scheda in base a un campo.

Le schede contengono controlli. I controlli di una scheda costituiscono l'esperienza per la visualizzazione e la modifica di un singolo campo. Ad esempio, una scheda numerica può essere costituita da un controllo Etichetta per fornire il nome visualizzato del campo e un controllo Input di testo per fornire un editor per il valore del campo. La scheda può anche avere un controllo Etichetta che mostra eventuali errori di convalida che si verificano e un controllo Etichetta per l'asterisco comune per indicare che è necessario un campo.

È possibile personalizzare i controlli di una scheda predefinita ridimensionandolo, spostandolo, nascondendolo, aggiungendo controlli e apportando altre modifiche. È anche possibile iniziare con una scheda completamente vuota, una "scheda personalizzata", a cui si aggiungono controlli da zero.

Le schede predefinite sono bloccate per impostazione predefinita. In una scheda bloccata è possibile modificare solo determinate proprietà della scheda o dei controlli all'interno della scheda e non è possibile eliminare una scheda bloccata. È possibile visualizzare il blocco della scheda e sbloccarlo nella scheda Visualizza della visualizzazione Avanzate . Se una proprietà è bloccata e non può essere modificata, viene visualizzata con un'icona di blocco accanto al nome. Sbloccare una scheda è un'attività avanzata e deve essere eseguita con attenzione, perché la generazione automatica della formula non si verificherà più per la scheda e non è possibile ribloccare una scheda.

All'interno del contenitore del modulo, il record ThisItem è disponibile e contiene tutti i campi del record. Ad esempio, la proprietà Default della scheda viene spesso impostata su ThisItem. FieldName.

È possibile utilizzare il riferimento padre per configurare un controllo per fare riferimento alle proprietà di una scheda. Ad esempio, un controllo deve usare Parent.Default per leggere lo stato iniziale del campo dall'origine dati. Usando Parent anziché accedere direttamente alle informazioni desiderate, la scheda è meglio incapsulata ed è possibile modificarla in un campo diverso senza interrompere le formule interne.

Per esempi su come personalizzare, sbloccare e creare schede, vedere Informazioni sulle schede dati .

Proprietà chiave

DataField : nome del campo all'interno di un record visualizzato e modificato dalla scheda.

• Specificare il nome come singola stringa statica racchiusa tra virgolette doppie ( ad esempio "Name"), non una formula.
• Annullare l'associazione di una scheda impostando la relativa proprietà DataFieldvuota. Le proprietà Valid e Update vengono ignorate per le schede non associate.

Impostazione predefinita : valore iniziale di un controllo prima che venga modificato dall'utente.

• Per ogni controllo in una scheda, impostare questa proprietà su Parent.Default per fare riferimento al valore predefinito del campo in base all'origine dati. Ad esempio, impostare la proprietà Default di un dispositivo di scorrimento su Parent.Default per assicurarsi che l'utente inizi con un valore generico per tale dispositivo di scorrimento.

DisplayMode : i valori possono essere Modifica, Visualizzazione o Disabilitato. Configura se il controllo all'interno della scheda consente l'input dell'utente (Modifica), visualizza solo i dati (Visualizzazione) o è disabilitato (Disabilitato).

• Consente l'utilizzo di una singola scheda nei moduli di modifica e visualizzazione, configurando questa proprietà, associata al comportamento del modulo per impostazione predefinita.
• In modalità Visualizzazione , i controlli figlio, ad esempio Input di testo, Elenco a discesa, Selezione data visualizzeranno solo il valore di testo e non eseguiranno il rendering di elementi o decorazioni interattivi.

DisplayName : nome descrittivo per un campo in un'origine dati.

• La funzione DataSourceInfo fornisce questi metadati dall'origine dati.
• I controlli all'interno della scheda devono usare Parent.DisplayName per fare riferimento al nome del campo.

Errore : messaggio di errore descrittivo da visualizzare per questo campo quando la convalida ha esito negativo.

• Questa proprietà viene impostata quando viene chiamato SubmitForm .
• Il messaggio descrive i problemi di convalida in base ai metadati dell'origine dati e al controllo della proprietà Required della scheda.

Obbligatorio : se una scheda, modificando il campo di un'origine dati, deve contenere un valore.

• La funzione DataSourceInfo fornisce i metadati necessari dall'origine dati.
• I controlli all'interno della scheda devono utilizzare Parent.Required per determinare se il campo della scheda è obbligatorio.

Update : valore da scrivere nell'origine dati per un campo.

• Utilizzare la formula di questa proprietà per eseguire il pull dei valori dai controlli di modifica della scheda per eseguire il writeback nell'origine dati. Ad esempio, impostare la proprietà Update di una scheda su Slider.Value per aggiornare l'origine dati con un valore dal dispositivo di scorrimento nella scheda.

Width : distanza tra i bordi sinistro e destro di un controllo.

WidthFit : indica se un controllo aumenta automaticamente orizzontalmente per riempire qualsiasi spazio vuoto in un controllo contenitore, ad esempio un controllo Modifica modulo . Se per più schede questa proprietà è impostata su true, lo spazio viene diviso tra di essi. Per altre informazioni, vedere Informazioni sul layout del modulo dati.

Proprietà aggiuntive

BorderColor : colore del bordo di un controllo.

BorderStyle : indica se il bordo di un controllo è Solido, Tratteggiato, Tratteggiato o Nessuno.

BorderThickness : spessore del bordo di un controllo.

Riempimento : colore di sfondo di un controllo.

Altezza : distanza tra i bordi superiore e inferiore di un controllo.

Valido : se un controllo Scheda o Modifica modulo contiene voci valide, pronto per l'invio all'origine dati.

Visibile : indica se viene visualizzato o nascosto 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. Per un controllo Scheda in un contenitore con più colonne, questa proprietà determina la colonna in cui viene visualizzata la scheda.

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. Per un controllo Scheda in un contenitore con più righe, questa proprietà determina la riga in cui viene visualizzata la scheda.

Esempi

Per esempi, vedere Informazioni sulle schede dati e Informazioni sul layout dei moduli dati .

Linee guida sull'accessibilità

Contrasto dei colori

Deve esserci un contrasto di colore adeguato tra:

• Compilare e tutti i controlli figlio. Ad esempio, se una scheda contiene un'etichetta e l'etichetta ha un riempimento trasparente, il riempimento della scheda diventa effettivamente il colore di sfondo per l'etichetta. Pertanto, dovrebbe esserci un contrasto adeguato tra il riempimento della scheda e il colore dell'etichetta.

Utilità per la lettura dello schermo

• DisplayName deve essere presente.