Saltar para o conteúdo principal
Versão: 20 R7 BETA

HIGHLIGHT TEXT

HIGHLIGHT TEXT ( {* ;} area ; inicioSel ; fimSel )

ParâmetroTipoDescrição
*OperadorSe especificado, objeto é um nome de objeto (string); se omitido, objeto é um campo ou variável.
areaField, Variable, anyNome de objeto (se * for especificado), ou campo editável ou variável (se * for omitido)
inicioSelIntegerPosição inicial da seleção de texto
fimSelIntegerPosição final da seleção de texto

Descrição

O comando HIGHLIGHT TEXT seleciona uma parte de texto em objeto.

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de um objeto (uma string) Se não passar o parâmetro *, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, passe a referência do campo ou da variável (campos ou variáveis de formulário apenas) ao invés de uma string.

Se objeto não for o objeto que está sendo modificado, esta área recupera o foco.

Nota: Este comando não pode ser utilizado com campos em um subformulário.

O parâmetro inicioSel representa a posição do primeiro caractere a selecionar, e o parâmetro fimSel representa a posição do último caractere a selecionar mais um. Se inicioSel e fimSel são iguais, o ponto de inserção está localizado antes do caractere especificado por inicioSel, e nenhum caractere está selecionado.

Se fimSel for superior ao número de caracteres em objeto, todos os caracteres entre inicioSel e o final do texto são selecionados.

Exemplo 1

O exemplo abaixo seleciona todos os caracteres no campo editável [Produtos]Notas:

 HIGHLIGHT TEXT([Produtos]Notas;1;Length([Produtos]Notas)+1)

Exemplo 2

O exemplo abaixo move o ponto de inserção ao começo do campo editável [Produtos]Notas:

 HIGHLIGHT TEXT([Produtos]Notas;1;1)

Exemplo 3

O exemplo abaixo move o ponto de inserção ao final do campo editável [Produtos]Notas:

 $vLen:=Length([Produtos]Notas)+1HIGHLIGHT TEXT([Produtos]Notas;$vLen;$vLen)

Exemplo 4

Ver o exemplo do comando FILTER KEYSTROKE.

Ver também

GET HIGHLIGHT

Propriedades

Número do comando210
Thread-seguro