# Variáveis locais

Variáveis locais são variáveis internas que só podem ser acessadas em uma tela, conteúdo ou seus scripts onde a variável local está configurada. Como as variáveis locais estão disponíveis apenas na tela/conteúdo, é conveniente para dados temporários.

Hide Show

1. Número máximo de variáveis locais
2. Nomenclatura e tipos de dados
3. Vinculação de dados
4. Copiando variáveis locais
5. Copiando objetos associados a variáveis locais
6. Outros

## Número máximo de variáveis locais

Você pode configurar até 300 variáveis locais por tela/conteúdo no software de edição de tela. Quando uma tela tem uma Visualização de conteúdo, e o número total de variáveis locais na tela e as variáveis locais nos conteúdos associados com a Visualização de conteúdo excedem 3600, ocorre um erro.

O número máximo de variáveis locais varia de acordo com o modelo de display. O número máximo de variáveis locais por projeto não está incluído no número máximo de variáveis globais por projeto.

Para obter informações sobre o número máximo de variáveis locais para cada modelo de display, consulte o seguinte.

Lista de modelos/recursos suportados

O número máximo de variáveis locais que podem ser carregadas nas telas que são desenhadas em runtime é de 3600. O desenho pára se o limite de 3600 variáveis locais for excedido e um erro do sistema for exibido.

Observação:

- Ao usar gestos de rolagem para alterar a tela/conteúdo para uma Visualização de conteúdo de slides ou Navegação do controle deslizante, as variáveis locais definidas nas telas/conteúdo anterior e seguinte que não são exibidas no momento também são incluídas no cálculo para o limite superior.

- Mesmo que um objeto não seja visível no runtime devido a sua configuração atual [Visibilidade], as variáveis locais definidas para o objeto também são incluídas no cálculo em direção ao limite superior.

- Se você indiretamente especificar o [ID do conteúdo] de um objeto de Visualização de conteúdo ou de um objeto de Visualização de conteúdo de slides, o software de edição de tela não pode contar as variáveis locais para esse conteúdo. Portanto, mesmo que não haja erro no software de edição de tela, o limite de variável local pode ser excedido em runtime e o conteúdo pode não ser exibido. Se isso acontecer, um erro de sistema será exibido.

## Nomenclatura e tipos de dados

Os nomes das variáveis locais devem ser únicos dentro de uma tela/conteúdo. Para obter informações sobre a convenção de nomenclatura para nomes de variáveis locais, consulte o seguinte.

Convenções de nomenclatura

Os tipos de dados suportados pelas variáveis locais são os mesmos que as variáveis básicas, exceto WSTRING. Os tipos de dados para variáveis do tipo de dados do usuário também não são suportados. Para obter informações sobre Tipos de dados, consulte o seguinte.

Tipo de dados

Você não pode usar uma variável global como número de elemento para variáveis de matriz local.

## Vinculação de dados

Você pode associar a propriedade de um objeto a uma variável local. Como as variáveis locais estão disponíveis apenas na tela/conteúdo, é conveniente para dados temporários. Ao fazer associações com uma variável local, o prefixo "$Local" é adicionado. Exemplo: $Local.Var1.Value

Como as variáveis locais não podem ser usadas para recursos globais, como alarme, registro de dados, leitor de código de barras USB e OPC UA, os recursos globais devem usar variáveis globais. Para obter informações sobre vinculação de dados, consulte o seguinte.

Vinculação de dados

## Copiando variáveis locais

Você pode copiar variáveis globais para variáveis locais e vice versa.

Ao copiar variáveis globais para variáveis locais, as propriedades relevantes são copiadas. Ao copiar variáveis locais para variáveis globais, os valores padrão são definidos em propriedades que não estão disponíveis em variáveis locais.

## Copiando objetos associados a variáveis locais

Você pode copiar um objeto associado a uma variável local para outra tela.

Quando a tela de destino não possui uma variável local com o mesmo nome, a caixa de diálogo [Alerta] será exibida.

Selecione o botão [Colar] para colar o objeto.

Selecione [Colar com Vinculação(ões)] para colar o objeto e suas variáveis locais associadas.

Quando a tela de destino possui uma variável local com o mesmo nome, o objeto é colado e a variável local na tela de destino é associada ao objeto copiado. Se o tipo de dados da variável local não corresponder, ocorrerá um erro no momento da compilação.

## Outros

Você não pode ler ou gravar variáveis locais usando o servidor OPC UA ou o Web API / WebSocket.