Régua de controle

Cria uma régua de controle com uma alça que pode ser arrastada para aumentar ou diminuir um número. É possível escolher o número de um intervalo de números e especificar o valor da etapa pelo qual a régua de controle aumenta ou diminui o número quando você desliza a alça.

Propriedades de configuração

Em Configuração, configure ou modifique as propriedades de aparência e comportamento para a visualização. Em Eventos, configure as propriedades de configuração de fórmula.

Tamanho da tela: Uma propriedade de configuração que possui o ícone Tamanhos de Tela ao lado do nome da propriedade pode ter valores diferentes para cada tamanho de tela.. Se um valor não for configurado, o tamanho da tela herdará o valor do próximo maior tamanho de tela como seu valor padrão.

Definições de tema: As definições de tema especificam as cores e os estilos para uma visualização e determinam sua aparência. É possível visualizar a aparência de visualizações no editor de tema. Consulte Temas.

As propriedades de configuração de aparência para a visualização Régua de controle são mostradas na tabela a seguir:

Tabela 1. Propriedades de configuração de aparência para a visualização Régua de controle
Propriedade de configuração de aparência	Descrição	Tipo de dados
Vertical	Quando selecionado, exibe a régua de controle verticalmente em vez de horizontalmente.	`Boolean`
Estilo de cor	Especifica um estilo de cor para a régua de controle. As cores correspondem às variáveis no tema especificado.	`String`
Altura	Especifica a altura da régua de controle em unidades `px` (pixels) ou `em` . Se nenhum tipo de unidade for especificado, `px` será assumido.	`String`
Largura	Especifica a largura da régua de controle em pixels, percentual ou unidades eme. Por exemplo: `50px` ou `20%` ou `0.4em`. Se nenhum tipo de unidade for especificado, `px` será assumido.	`String`
Raio da borda	Especifica o raio da curvatura para os cantos da barra da régua de controle.	`String`
Largura do identificador	Especifica a largura do identificador em pixels (`px`) ou unidades `em` . Por exemplo: `50px` ou `0.4em`. Se nenhuma unidade for especificada, `px` será assumido (`%` deve ser evitado).	`String`
Raio de alça	Especifica o raio da curvatura para os cantos da alça.	`String`
Mostrar valor atual	Mostra o valor de régua de controle atual, que pode ser mudado digitando um valor diferente.	`Boolean`
Mostrar valores limite	Mostra os valores mínimo e máximo para o intervalo de régua de controle.	`Boolean`

As propriedades de configuração de comportamento para a visualização Régua de controle são listadas na tabela a seguir:

Tabela 2. Propriedades de configuração de comportamento para a visualização Régua de controle
Propriedade de configuração de comportamento	Descrição	Tipo de dados
Mínimo	Especifica o valor mínimo no intervalo de régua de controle.	`Decimal`
Maximum	Especifica o valor máximo no intervalo de régua de controle.	`Decimal`
Etapa	Especifica o valor da etapa para a régua de controle.	`Decimal`
Índice de guias	Especifica o índice de sequência de tabulação do controle de formulário. Os índices de tabulação iniciam em 1 e podem ser configurados esparsamente. Por exemplo, é possível usar 1, 5, 10. A propriedade do índice de tabulação controla a sequência de tabulação quando você se move entre áreas da UI pressionando a tecla Tab.	`Integer`

Eventos

Configure ou modifique as propriedades de configuração de fórmula e os manipuladores de eventos para a visualização nas propriedades Eventos. É possível configurar eventos para que sejam acionados programaticamente ou quando um usuário interage com a visualização. Para obter informações sobre como definir e codificar eventos, consulte Eventos definidos pelo usuário.

As propriedades de configuração de fórmula para a visualização Régua de controle são mostradas na tabela a seguir:

Tabela 3. Propriedades de configuração de fórmula para a visualização Régua de controle
Propriedade de configuração de fórmula	Descrição	Tipo de dados
Fórmula de valor	Especifica a fórmula ou expressão a ser usada quando os valores de régua de controle são calculados automaticamente para a visualização. Nenhuma fórmula é especificada por padrão. Para obter mais informações sobre as fórmulas, consulte Fórmulas	`String`

A visualização Régua de controle tem os tipos de manipuladores de eventos a seguir:

On load: ativado quando a visualização for carregada. Por exemplo:
```
me.setValue(50)
```

On change: ativado quando o valor de régua de controle é mudado. Por exemplo:

if (newVal > 50) {${icon}.setIcon("smile-o");} else {${icon}.setIcon("frown-o");}

Métodos

Para obter informações detalhadas sobre os métodos disponíveis para a visualização Slider, consulte a API Slider JavaScript .

Recursos adicionais

Para obter informações sobre como criar um coach ou página, consulte Construindo coaches..
Para obter informações sobre propriedades padrão (Geral, Configuração, Posicionamento, Visibilidadee Atributos HTML), consulte Visualizar propriedades.