HIGHLIGHT TEXT

HIGHLIGHT TEXT ( * ; area : Text ; inicioSel : Integer ; fimSel : Integer )
HIGHLIGHT TEXT ( area : Variable, Field ; inicioSel : Integer ; fimSel : Integer )

Parâmetro	Tipo		Descrição
*	Operador	→	Se especificado, objeto é um nome de objeto (string); se omitido, objeto é um campo ou variável.
area	Field, Variable, any	→	Nome de objeto (se * for especificado), ou campo editável ou variável (se * for omitido)
inicioSel	Integer	→	Posição inicial da seleção de texto
fimSel	Integer	→	Posição final da seleção de texto

Histórico

Versão	Alterações
12	Modificado
<6	Criado

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 comando	210
Thread-seguro	no