# Avanzamento

> Riferimento del componente di dashboard Avanzamento, una lettura limitata come barra, bargraph o scala a bande, con ogni proprietà dell'editor.

Il componente **Avanzamento** disegna una lettura numerica limitata lungo una traccia. Le sue tre presentazioni rispondono a domande diverse sullo stesso valore, cioè quanta parte dell'intervallo è occupata, quanti passi ne sono occupati e in quale tratto dichiarato si trova la lettura, ed è per questo che sono una scelta e non uno stile. Una traccia senza lettura non disegna alcun riempimento (una barra vuota si leggerebbe come uno zero misurato) e mostra il segno del vuoto, un trattino, dove va il numero. Anche `NaN` è una lettura e non un vuoto: questa parola viene scritta accanto alla sua unità e la traccia resta vuota, perché `NaN` non ha posto sulla scala.

## Contenuto e dati {#content-and-data}

| Proprietà | Che cosa fa | Valori | Predefinito |
|---|---|---|---|
| Etichetta | Didascalia facoltativa sopra la traccia. Un'etichetta lunga si tronca con tutta se stessa nel suggerimento e non toglie mai spazio alla lettura. | testo | vuoto |
| Indirizzo | Indirizzo radicato di Logic del punto numerico mostrato. Il campo suggerisce dall'elenco dei punti in tempo reale, filtrato ai punti numerici, e mostra la lettura corrente del punto una volta nominato. | indirizzo | vuoto |

## Formato {#format}

| Proprietà | Che cosa fa | Valori | Predefinito |
|---|---|---|---|
| Min. | Dove comincia la scala, nell'unità ingegneristica del punto. | numero | 0 |
| Max. | Dove finisce la scala. Sotto il Min. non c'è nessuna scala su cui collocare una lettura. | numero | 100 |
| Unità di misura | Suffisso di unità facoltativo accanto alla lettura. | testo | vuoto |
| Decimali | Numero fisso di decimali per la lettura. Se resta vuoto, un punto il cui tipo è un numero intero viene scritto senza frazione, e ogni altro numero con i decimali della stazione. Con il campo vuoto anche il riferimento e gli estremi della scala seguono i decimali del punto, come la lettura: nessuno su un numero intero, quelli della stazione su ogni altro. | da 0 a 15 | vuoto usa la preferenza della stazione |
| Cifre | Quanti posti riserva la lettura prima del separatore decimale; una lettura che li supera viene segnata (`####`) con tutta se stessa nel suggerimento. Un punto che risponde con parole (un ordine, un lotto, uno stato) non porta mai quel segno: ciò che il campo non può contenere finisce con i puntini (…), con la lettura intera nel suggerimento. | da 1 a 20 | vuoto lo ricava dal maggiore fra Min. e Max. |
| Corpo del carattere | Se la dimensione del carattere la decide la cella oppure la dichiara l'operatore. | Grande quanto la cella consente · Un corpo indicato | Grande quanto la cella consente |
| Punti | La dimensione dichiarata. Mostrata soltanto nel modo dichiarato. | da 9 a 144 | 12 |
| Si legge come | Come viene scritta la lettura. | Numero · Percentuale · Durata | Numero |
| Il valore conta | Che cosa significa un'unità del valore mentre il formato è una durata. | Secondi · Millisecondi · Minuti | Secondi |
| Scrivi la lettura | Se la lettura viene scritta accanto alla traccia. | attivo / disattivo | attivo |
| Scrivi gli estremi della scala | Se i due estremi vengono scritti sotto la traccia. | attivo / disattivo | disattivo |

## Barra {#track}

| Proprietà | Che cosa fa | Valori | Predefinito |
|---|---|---|---|
| Disegna | La presentazione: un riempimento continuo dall'inizio della scala fino alla lettura; lo stesso riempimento tagliato in celle uguali accese fino alla lettura (un bargraph); oppure le bande dichiarate dipinte lungo la traccia con la lettura che le percorre come segno, senza nessun riempimento, perché la domanda è dove sulla scala si trovi il valore, non quanta ne sia usata. | Una barra riempita fino alla lettura · Segmenti accesi fino alla lettura · Le fasce, con la lettura segnata su di esse | Una barra riempita fino alla lettura |
| Direzione | In che direzione corre la traccia: per la larghezza della cella con la scala che comincia dal bordo sinistro, oppure per l'altezza della cella con la scala che comincia dal fondo, cioè una colonna di livello. | Per la larghezza della cella · Per l'altezza della cella | Per la larghezza della cella |
| Celle | In quante celle è tagliata una traccia a segmenti. Chiesto soltanto a quella presentazione. | da 2 a 50 | 10 |
| La scala parte dall'estremo opposto | Inverte la direzione della scala, così il riempimento cresce indietro verso l'estremità vicina. È soltanto la direzione, mai una seconda coppia di estremità: Min resta il minimo. | attivo / disattivo | disattivo |
| Accento | Da dove viene il colore del riempimento. Identità, non significato: le bande tengono l'ultima parola sul significato della lettura. | Il colore ordinario del testo · Un colore · Un punto di colore | Il colore ordinario del testo |
| Chiaro / Scuro | L'accento come coppia chiara e scura, entrambe dichiarate perché il tema in funzione decide quale metà è sullo schermo. Mostrato soltanto mentre l'accento è un colore. | `#RRGGBB` ciascuno | `#5470C6` entrambi |
| Punto di colore | Indirizzo radicato di Logic di un punto Colore che l'accento segue. Mostrato soltanto mentre l'accento è un punto di colore. | indirizzo | vuoto |

## Scala {#scale}

La sezione **Scala** condivisa dichiara le bande e il riferimento.

- Ogni **banda** copre tutto fino al suo limite, da dove è finita la banda sopra di essa; una lettura oltre l'ultimo limite non appartiene a nessuna banda. Il tono (Neutro, Informazione, Esito positivo, Attenzione, Critico) tinge la lettura scritta, e nella presentazione a bande le bande sono la traccia stessa, dipinta che il punto risponda oppure no, perché sono la dichiarazione, non la misura. Una banda con una dicitura scrive il proprio nome nella testa, prima del numero, così la lettura conserva la fine della riga.
- Il **riferimento** segna sulla traccia un setpoint o un nominale: nulla, un valore fisso oppure un punto che si muove con la ricetta. Il suggerimento del segno porta il valore di riferimento, e il segno viene disegnato soltanto finché la scala lo raggiunge.