# Valor

> O mostrador ao vivo formatado: um ponto escrito por extenso com unidade, casas decimais, uma largura de campo declarada e faixas de significado opcionais.

**Valor** é o mostrador básico: ele escreve um ponto do espaço de endereços ao vivo dentro
da célula dele, formatado do jeito que você declara. A leitura toma a célula inteira: uma
legenda para ela é um [Rótulo](component-label) que você põe ao lado, ou o título de canto
do próprio componente, na seção Aparência compartilhada. É um componente de *Exibição*; um
novo ocupa 4 × 2 células.

Um Valor nunca mostra um número velho. Um ponto que não consegue ler desenha o traço de
lacuna (`—`) na tinta secundária discreta, e o componente ganha a marca compartilhada de
leitura ruim descrita na
[página de componentes](components#addresses-and-live-readings). Um ponto que responde com
qualidade boa mas não guarda valor neste momento (uma bancada entre execuções, um contador
fora de um ciclo) desenha o mesmo traço *sem* a marca: aquele silêncio é normal, não uma
falha.

## Dados {#data}

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Endereço | O endereço com raiz, na Logic, do ponto mostrado. A lista sugere pontos ao vivo de toda categoria de valor: um mostrador formata o que quer que o ponto guarde, um número, um texto, um sinalizador, um instante. | Texto livre; sugestões da lista de pontos ao vivo | vazio |

Sob o campo, o editor mostra o que o ponto escolhido lê neste momento, então o vínculo se
confirma antes mesmo de a tela rodar.

## Formato {#format}

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Unidade | Sufixo de unidade escrito ao lado do valor, num tamanho menor, na tinta secundária. Ele faz parte da largura de campo reservada, então nunca escapa da linha. Escondido enquanto o ponto não está lendo. | Texto livre | vazio |
| Decimais | Casas decimais fixas para leituras numéricas. Em branco segue a preferência decimal da estação (veja a [página de configurações](settings-localization)), e um ponto cujo tipo é um número inteiro é então escrito sem fração. Entradas fora da faixa são tomadas na borda mais próxima, e o painel diz isso. Os formatos de relógio e de palavras não escrevem fração, então a contagem não é lida ali. | de 0 a 15, ou em branco | em branco (preferência da estação) |
| Dígitos / Caracteres | Quanto o campo comporta: a declaração por trás do contrato de exibição de valores. Como **Dígitos** (formatos numéricos): casas antes do separador decimal; uma leitura que precisa de mais é *marcada*, nunca escrita cortada. Como **Caracteres** (o formato Texto): quantos caracteres a linha comporta; uma leitura mais longa é escrita cortada com reticências. O campo é nomeado pela medida que o formato escolhido declara. | Dígitos: de 1 a 20 · Caracteres: de 1 a 40, ou em branco | 5 dígitos · 12 caracteres |
| Tamanho da fonte | Se a célula decide o tamanho do texto ou se você o declara. | `Tão grande quanto a célula permitir` · `Um tamanho que eu defino` | `Tão grande quanto a célula permitir` |
| Pontos | O tamanho declarado do texto. Mostrado só no modo declarado. Um tamanho declarado é literal: ele desenha naquele tamanho em qualquer célula e nunca é reduzido para a leitura caber; o que deixa de caber é marcado, não encolhido. | de 9 a 144 pontos | 12 |
| Lê-se como | Como a leitura é escrita por extenso. | `Número` · `Porcentagem` · `Duração` · `Texto` | `Número` |
| O valor conta | O que uma unidade do valor significa enquanto **Lê-se como** é `Duração`. O tempo decorrido chega como um número comum, e o mesmo número é milissegundos num ponto e minutos em outro, então o componente declara qual é. Mostrado só no formato de duração. | `Segundos` · `Milissegundos` · `Minutos` | `Segundos` |

### Os quatro formatos {#the-four-formats}

- **Número** escreve o número de engenharia na preferência decimal da estação, ou nas casas declaradas em
  **Decimais**. Um número inteiro sem casas declaradas é escrito sem
  fração, com todos os dígitos que ele guarda, por maior que seja.
- **Porcentagem** escreve o mesmo número seguido de `%`. O valor *não* é reescalado: o ponto
  já é uma porcentagem; a matemática da cadeia de valor fica nos estágios de conversão do
  Connector.
- **Duração** escreve um relógio: `hh:mm:ss`, ou `d.hh:mm:ss` a partir de um dia. Uma
  contagem negativa mantém o sinal dela. É o mesmo relógio que as ocorrências de execução, as
  linhas dos Históricos e o relatório em PDF usam.
- **Texto** escreve as palavras em que o ponto responde, uma ordem, um lote, o nome de um
  perfil, exatamente como elas chegam. Escolhê-lo também é a declaração de que a largura do
  campo conta **caracteres** em vez de dígitos, o que muda o nome do campo de largura, o
  padrão dele e a conduta dele (reticências em vez da marca de estouro).

Número, Porcentagem e Duração dizem como um *número* é escrito, e o tipo do ponto decide se
a leitura é um, do mesmo jeito que em todo o resto da estação. Uma leitura que não é número
nenhum (um sinalizador, um texto, um instante) ainda assim respondeu, então ela é escrita
como é, em vez de virar lacuna, qualquer que seja o escolhido dos três: um sinalizador
aparece como `true` ou `false`, nunca como um número com casas decimais, uma porcentagem ou
um relógio. `NaN` também é uma leitura: ele é escrito como essa palavra, ao lado da unidade,
e nunca como o traço de lacuna.

## Como a leitura é desenhada {#how-the-reading-is-drawn}

O tamanho do texto nunca segue o valor. No modo automático a célula decide o tamanho,
limitada pela largura que a declaração reserva (dígitos + separador + casas decimais +
unidade, ou os caracteres declarados); no modo declarado o tamanho é exatamente os pontos
que você digitou. Duas células do mesmo tamanho com as mesmas declarações sempre saem no
mesmo tamanho, e um valor que oscila entre quatro e seis caracteres nunca mexe no texto.

O que acontece quando o conteúdo passa da declaração dele:

| Situação | O que a célula mostra |
|---|---|
| Um número precisa de mais dígitos do que os declarados | A marca de estouro `####`, com a leitura inteira (com a unidade) na dica. A marca significa exatamente uma coisa: este campo não comporta este número. |
| Um tamanho declarado precisa de mais largura do que a célula tem | A mesma marca `####`: um tamanho literal nunca é encolhido. Sob um tamanho declarado a dica sempre carrega a leitura inteira. |
| Uma leitura de Texto é mais longa que os caracteres declarados | Cortada com reticências, com o texto inteiro na dica. As palavras nunca ganham a marca do número. |
| Uma leitura em palavras é mais longa que o campo enquanto o Valor se lê como Número, Porcentagem ou Duração | Cortada com reticências, com a leitura inteira (com a unidade) na dica. As palavras nunca ganham a marca do número, nem quando são só algarismos. |
| O ponto não está lendo | O traço de lacuna `—`. A ausência de uma leitura e a ausência de espaço nunca tomam emprestada a marca uma da outra. |

Os números se apoiam à direita do campo deles em algarismos tabulares, para que uma coluna de
componentes Valor se alinhe consigo mesma e o separador mantenha o lugar dele conforme a
parte inteira cresce.

## Escala {#scale}

A declaração opcional de faixas, compartilhada pelos tipos de leitura: cada faixa cobre a
extensão do valor até o limite dela, começando onde a faixa acima dela na lista terminou, e
uma leitura além do último limite não pertence a faixa nenhuma. As faixas *tingem* o número
com os tons de significado da própria interface; uma leitura que nenhuma faixa reivindica
mantém a tinta comum.

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Até | Onde a faixa termina (inclusive), na unidade de engenharia do ponto. Uma faixa nova começa com o campo vazio, e um limite vazio não é zero: a faixa não reivindica nada e não tinge nada até um limite ser digitado. | Qualquer número | vazio |
| Significado | O que uma leitura dentro da faixa significa. O tom nomeia o significado; o tema em vigor decide a tinta. | `Neutro` · `Informação` · `Sucesso` · `Atenção` · `Crítico` | `Neutro` |
| Nomeia este estado | Redação opcional para a faixa ("Aquecimento", "Sobrepressão"). Redigir qualquer faixa acrescenta uma linha de estado sob o número, que escreve a palavra da faixa atual, no tom dela. | Texto livre | vazio |

A linha de estado só existe enquanto ao menos uma faixa está redigida. Ela mantém a altura
dela enquanto nada está nomeado, para que o número acima nunca mude de tamanho quando uma
leitura cruza um limite, e ela corta com reticências, com a palavra inteira na dica dela. As
setas de mover para cima e para baixo trocam o significado e a redação de uma faixa com a
vizinha, deixando os limites digitados no lugar.

O Valor é um componente de exibição: ele não comanda nada, então nunca ganha a marca de
trava. As seções compartilhadas Aparência, Identificação, Posição e camada e Ações estão descritas na
[página de componentes](components#the-shared-property-sections).