Controllo Etichetta nelle app canvas

Casella che visualizza dati come testo, numeri, date o valuta.

Descrizione

Un'etichetta consente di visualizzare dati specificati sotto forma di stringa letterale di testo, quindi visualizzati esattamente come vengono digitati, o sotto forma di formula che restituisce una stringa di testo. Le etichette compaiono spesso all'esterno di altri controlli, ad esempio di un banner che identifica una schermata, come etichette di identificazione di altri controlli, ad esempio di un controllo audio o classificazione, o in una raccolta, per visualizzare un tipo di informazioni specifico su un elemento.

Proprietà chiave

AutoHeight: imposta su true per consentire l'aumento automatico dell'altezza dell'etichetta e visualizzare tutto il testo. Imposta su false per troncare il testo all'altezza assegnata.

Color: colore del testo di un controllo.

Font: nome della famiglia di caratteri in cui viene visualizzato il testo.

Text: testo visualizzato in un controllo o che l'utente digita in un controllo.

DelayOutput: imposta su true per ritardare l'azione durante l'input di testo.

Proprietà aggiuntive

Align: posizione del testo in relazione al centro orizzontale del relativo controllo.

AutoHeight: indica se un'etichetta aumenta automaticamente la proprietà Height nel momento in cui la sua proprietà Text contenga più caratteri di quelli visualizzabili dal controllo in un determinato momento.

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.

DisplayMode: indica se il controllo consente l'input dell'utente (Edit), visualizza solo i dati (View) o è disabilitato (Disabled).

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.

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.

FontWeight: spessore del testo di un controllo. Può essere Bold (Grassetto), Semibold (Semibold), Normal (Normale) o Lighter (Sottile).

Height: distanza tra i bordi superiore e inferiore del controllo.

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.

LineHeight: distanza, ad esempio, tra le righe di testo o le voci di un elenco.

Live: come una schermata dell'utilità per la lettura dello schermo annuncia le modifiche al valore della proprietà Text dell'etichetta.

  • Quando impostato su Off, l'utilità per la lettura dello schermo non annuncia le modifiche.
  • Quando impostato su Polite, l'utilità per la lettura dello schermo termina di parlare prima di annunciare eventuali cambiamenti che si sono verificati mentre l'utilità per la lettura dello schermo stava parlando.
  • Quando impostato su Assertive, l'utilità per la lettura dello schermo si arresta per annunciare eventuali cambiamenti che si sono verificati mentre l'utilità per la lettura dello schermo stava parlando.

OnSelect: risposta dell'app quando l'utente tocca o fa clic su un controllo.

Overflow: indica se viene visualizzata una barra di scorrimento in un'etichetta se la proprietà Wrap è impostata su true e il valore della proprietà Text del controllo contiene più caratteri di quelli visualizzabili dal controllo in un determinato momento.

PaddingBottom: distanza tra il testo in un controllo e il bordo inferiore del controllo.

PaddingLeft: distanza tra il testo in un controllo e il bordo sinistro del controllo.

PaddingRight: distanza tra il testo in un controllo e il bordo destro del controllo.

PaddingTop: distanza tra il testo in un controllo e il bordo superiore del controllo.

PressedBorderColor: colore del bordo di un controllo quando l'utente tocca o fa clic su tale controllo.

PressedColor: colore del testo di un controllo quando l'utente tocca o fa clic su tale controllo.

PressedColor: colore dello sfondo di un controllo quando l'utente tocca o fa clic su tale controllo.

Role: il ruolo semantico del testo dell'etichetta, ad esempio Titolo 1. Non cambia lo stile dell'etichetta ma rende l'output semanticamente corretto per l'interpretazione da parte delle utilità per la lettura dello schermo.

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.

VerticalAlign: posizione del testo di un controllo in relazione al centro verticale di tale controllo.

Visible: indica se un controllo viene visualizzato o è nascosto.

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

Wrap: indica se il testo troppo lungo per l'etichetta deve andare a capo nella riga successiva.

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.

X: distanza tra il bordo superiore di un controllo e il bordo superiore del contenitore padre o della schermata se non c'è un contenitore padre.

Text( Number, "FormatCodes" )

Esempi

Visualizzare una stringa letterale

Visualizzare il risultato di una formula

  • Aggiungi un'etichetta e impostane la proprietà Text su una formula, ad esempio la formula seguente:
    Today()

    Nota

    Se specifichi una formula, usi le virgolette solo se un argomento della formula è una stringa letterale. In questo caso racchiudi l'argomento, non la formula, tra virgolette doppie.

    Sono necessarie altre informazioni su Today o su altre funzioni?

In questa procedura crei la raccolta CityPopulations contenente i dati sulla popolazione di diverse città europee. I dati verranno quindi visualizzati in una raccolta contenente tre etichette, per ognuna delle quali si specificherà il tipo di dati che deve essere visualizzato.

  1. Aggiungi un pulsante e impostane la proprietà OnSelect su questa formula:
    ClearCollect(CityPopulations, {City:"London", Country:"United Kingdom", Population:8615000}, {City:"Berlin", Country:"Germany", Population:3562000}, {City:"Madrid", Country:"Spain", Population:3165000}, {City:"Rome", Country:"Italy", Population:2874000}, {City:"Paris", Country:"France", Population:2273000}, {City:"Hamburg", Country:"Germany", Population:1760000}, {City:"Barcelona", Country:"Spain", Population:1602000}, {City:"Munich", Country:"Germany", Population:1494000}, {City:"Milan", Country:"Italy", Population:1344000})

  2. Premei F5, seleziona il pulsante e quindi premi ESC.

  3. Aggiungi una raccolta di testi e impostane la proprietà Items su CityPopulations.

    Quando la raccolta è selezionata, il riquadro di destra visualizza le opzioni disponibili per la raccolta stessa.

  4. Nel riquadro Raccolta1 imposta l'elenco superiore su Population, l'elenco intermedio su City, e l'elenco inferiore su Country.

Linee guida per l'accessibilità

Nonostante il nome, un controllo Etichetta non deve essere usato come etichetta per un altro controllo. Può essere usato per visualizzare qualsiasi parte del testo.

Un controllo Etichetta può essere usato come pulsante o collegamento specificando il comportamento OnSelect. Se usato in questo modo, le considerazioni sull'accessibilità sono simili a quelle per i pulsanti.

Contrasto dei colori

È necessario un contrasto dei colori adeguato tra:

Supporto utilità per la lettura dello schermo

  • Text deve essere presente.

  • Live  deve essere impostato su Polite o Assertive se un'utilità per la lettura dello schermo deve annunciare le modifiche al valore della proprietà Text.

    Nota

    Le utilità per la lettura dello schermo considerano i controlli Etichetta come pulsanti, se il valore di TabIndex è uguale o superiore a zero.

Supporto per ipovisione

  • L'aspetto del controllo Etichetta deve essere simile a un collegamento, se viene usato come tale.

Supporto per la tastiera

  • Il valore di TabIndex deve essere uguale o superiore a zero, se il testo viene usato come pulsante o collegamento. In questo modo, gli utenti della tastiera possono passare a questo controllo.
  • Gli indicatori di attivazione devono essere chiaramente visibili, se il testo viene usato come pulsante o collegamento. A questo scopo, usa FocusedBorderColor e FocusedBorderThickness.