Códigos de filtros e formatos

Nota preliminar: esta seção descreve os caracteres usados usados para definir os filtros de entrada e os formatos de visualização alfanuméricos. Os caracteres usados para os formatos de visualização numéricos são descritos na seção Formatos de saída.

O código de um filtro de entrada tem três partes, na seguinte ordem:

caractere de inicialização "argumento" guias

• O caractere de inicialização informa a 4D que o argumento posterior deve ser utilizado como filtro durante a entrada de dados no campo.
• O argumento define os caracteres permitidos.
• As guias definem as posições disponíveis para os caracteres.

Por exemplo, o seguinte filtro de entrada só permite a entrada das letras “a”, “b”, “c”, ou “g” em duas posições:

&"a;b;c;g"##

Neste exemplo, o caractere (&) é o caractere de inicialização; “a;b;c;g” é o argumento; e os signos de número (#) são as guias. Este filtro pode ser interpretado como “Permitir as letras ‘a’, ‘b’, ‘c’, ou ‘g’ em duas posições”. O usuário poderá digitar “ag”, “gc”, “ba”, “ab”, “aa”, “ac”, ou qualquer outra combinação dos quatro caracteres autorizados.

Os filtros de entrada podem ser combinados. O seguinte filtro de entrada só  permite a entrada das letras “a”, “b”, “c”, ou “g” em duas posições, seguidas por 1, 3, ou 8:

&"a;b;c;g"#,#&"1;3;8"#

O usuário deve usar duas das letras autorizadas, seguidas por um dos números autorizados.

Um formato de visualização combina os caracteres guias e os caracteres padrão.

Dois caracteres podem marcar o início de um filtro: o signo ampersand (&) e o til (~). Esses caracteres informam a 4D que utilize o argumento que os segue como o filtro para as guias posteriores.

Adicionalmente, o til (~) também informa a 4D que deve passar as letras a maiúsculas. O signo não evita a entrada de letras minúsculas, simplesmente as transforma em maiúsculas.

Os seguintes filtros de entrada tem os mesmos efeitos:

&"P"#
~"p"#

A diferença entre eles é que o filtro que contém o signo  (&) não aceita a letra “p” minúscula, enquanto o filtro iniciado com o til (~) aceita a entrada de “p” e a transforma em maiúscula.

Como nenhuma letra está envolvida, os seguintes filtros de entrada são equivalentes:

&"1;5;8"#
~"1;5;8"#

O argumento de um filtro de entrada segue o caractere de inicialização e define os caracteres autorizados para as guias posteriores. Para criar um argumento de um filtro, escreva os caracteres permitidos entre aspas.

Os argumentos aceitam letras minúsculas, maiúsculas, números, signos de pontuação, e caracteres especiais (!@#$%^&*(){}[]":';?><,./`~). Se usar uma letra minúscula em um argumento, o usuário apenas poderá introduzir essa letra como minúscula. Se usa uma maiúscula no argumento, o usuário apenas poderá introduzir essa letra como maiúscula.

• Um argumento pode conter um caractere simples (uma letra ou um número), por exemplo, “j”, “J”, ou “6”.
• Um argumento pode conter um conjunto de caracteres separados por ponto e vírgula (;), por exemplo “a;r;t” ou “1;5”.
• Um argumento pode conter faixas de caracteres. Uma faixa de caracteres está definido pelo primeiro caráter, um hífen e o último caractere. Exemplo, “a-c” e “1-5”. O argumento “a-c” é equivalente a “a;b;c”, e “1-5” é equivalente a “1;2;3;4;5”.
• Um argumento pode conter letras e números independentes e um ou mais faixas, por exemplo, “a;m-z;3;5-9.”

A seguiente tabela mostra algumas abreviações de argumentos comuns. As abreviações são utilizadas em filtros sem aspas:

Os seguintes filtros de entrada são equivalentes:

&9#
&"0-9"#
&"1;2;3;4;5;6;7;8;9;0"#

&a#
&"a-z;A-Z"#

Os seguintes filtros de entrada são equivalentes:

&A#
&"A-Z"#

O sinal  número (#) é o único caractere guia existente para os filtros e formatos alfanuméricos (outros caracteres estão disponíveis para os filtros e formatos numéricos). Um signo numérico é usado por cada caractere que o usuário possa introduzir no campo.

Por exemplo, o seguinte filtro de entrada permite ao usuário introduzir quatro letras:

&a####

O seguinte filtro de entrada permite ao usuário introduzir três letras maiúsculas, seguidas por dois números:

&A###&9##

Se não utiliza os caracteres guia no código do filtro, permite qualquer número de caracteres. O seguinte filtro de entrada permite que o usuário introduza somente números, mas não limita a quantidade de números introduzidos:

&9

Nota: pode definir o número máximo de caracteres permitidos num campo alfanumérico desde o editor de estrutura. (ver Tipos de campos 4D).

Quando um campo com um filtro de entrada é selecionado para a entrada de dados, 4D mostra um subscrito (_) por cada guia. A medida que o usuário introduz caracteres válidos, cada subscrito é ressaltado e substitui pelo caractere introduzido pelo usuário.

Você indica a 4D qual caractere substitui pelo subscrito ao começar o filtro de entrada com um ponto de exclamação (!) e o caractere que deseja.

Pode substituir o subscrito por qualquer outro caractere. Por exemplo, se mostra “XXXX” e o usuário escreve apenas dois dos caracteres autorizados (por exemplo “AA”), o campo conterá “AAXX” ao salvar o registro.

A seguinte imagem mostra um campo selecionado que contém subscritos e zeros.

Todo caractere, sinal de pontuação, e espaços, podem ser usados como caracteres ignorados. Os caracteres ignorados aparecem durante a entrada de dados, mas são ignorados pelo cursor e não formam parte da informação.

Os caracteres que deseja usar como caracteres ignorados são localizados ao início, ao final ou entre os caracteres guia, para proporcionar claridade ao usuário durante a entrada de dados.