Seletor

Opções registradas sobre um ponto, como teclas ou como lista, mostrando em qual delas a planta realmente está.

Seletor oferece ao operador um conjunto fechado de escolhas registradas, um modo de operação, uma receita, um degrau de velocidade, sobre um ponto escrevível. Escolher uma escreve o valor daquela opção; o mesmo ponto lido de volta é o que acende a opção ativa. Essa leitura de volta é a razão inteira de o tipo existir: uma fileira de Botões cada um escrevendo um valor fixo escreve igualmente bem e não mostra nada. É um componente de Controle; um novo ocupa 5 × 1 células.

Dados

Campo	O que ele faz	Valores	Padrão
Endereço	O endereço com raiz, na Logic, em que a escolha é escrita e de onde ela é lida de volta: uma variável de memória ou uma tag escrevível. A lista é estreitada para pontos que podem mesmo ser escritos.	Texto livre; sugestões de pontos escrevíveis	vazio

Opções

Campo	O que ele faz	Valores	Padrão
Mostra	Como as opções são oferecidas: uma tecla por opção, lado a lado, toda escolha legível de uma vez, ou uma lista que abre sob demanda, para uma célula sem espaço para uma fileira de teclas.	`Uma tecla por opção` · `Uma lista que abre`	`Uma tecla por opção`

Cada opção é um cartão com as duas coisas que uma opção é:

Campo	O que ele faz	Valores	Padrão
texto	A palavra que o operador lê na tecla ou na lista. Em branco recai no próprio valor, porque uma tecla sem nada escrito não diz nada.	Texto livre	vazio
valor	O valor escrito quando esta opção é escolhida, e a leitura que a mostra ativa. É um código, casado exatamente: o que fica entre dois códigos não é uma escolha.	Qualquer número	vazio (não declara nada até ser digitado)

A ordem dos cartões é a ordem das teclas sob a mão do operador: as setas de mover para cima e para baixo reordenam; nada aqui se ordena sozinho. Duas opções que nomeiam o mesmo valor não podem desenhar as duas uma tecla (o ponto poderia relatar só uma delas, e o controle não teria como dizer qual); o painel diz isso e a duplicata não desenha nada.

Todas as teclas compartilham um tamanho de texto só, reservado a partir da palavra registrada mais larga, para que a fileira se leia como um controle só, e não como uma fileira de teclas sem relação. Um Seletor sem opções diz "Nenhuma opção registrada." em vez de desenhar uma fileira vazia que parece uma tela ainda carregando.

O que acende, e quando

A tecla acesa (ou a seleção da lista) é a própria leitura do ponto, nunca o clique:

Situação	O controle mostra
O ponto relata um valor registrado	Aquela opção acesa, ou selecionada na lista
O ponto relata um valor que opção nenhuma registra	Nada aceso: a tecla mais próxima acendendo seria a tela inventando o modo da planta
O ponto não está lendo	Nada aceso, e o componente ganha a marca compartilhada de leitura ruim

Uma escolha não pede leitura nenhuma antes, porque a opção carrega um valor absoluto, então a qualidade ruim deixa o controle usável e apenas tira a indicação.

Semântica da escrita

Escolher uma opção escreve o valor dela pelo funil único da lógica da estação, sob a mesma autorização por que todo comando passa. Um ponto que não pode guardar um número recusa a escrita com a razão na linha de resposta do controle ("Este ponto guarda texto, então 2 não é um valor que ele aceita."); uma escolha bem-sucedida responde com a palavra da opção ("Escreveu Automático"). A linha de resposta expira depois de alguns segundos, e a autorização é reconferida a cada escolha.

Permissões e a trava

Operar o Seletor exige a permissão do papel para operar dashboards. Um toque bloqueado desabilita as teclas e desenha a marca de trava compartilhada com a razão na dica do componente (veja a página de dashboards).

As seções compartilhadas Aparência, Identificação, Posição e camada e Ações estão descritas na página de componentes.