HIGHLIGHT TEXT
HIGHLIGHT TEXT ( {* ;} area ; inicioSel ; fimSel )
| 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 |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
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.