4D v14.3

GET HIGHLIGHT

Página Inicial

 
4D v14.3
GET HIGHLIGHT

GET HIGHLIGHT 


 

GET HIGHLIGHT ( {Objeto ;} area ; inicioSel ; fimSel ) 
Parâmetro Tipo   Descrição
Objeto  Operador in Se especificado, objeto é um nome de objeto (string=. Se omitido, objeto é um campo ou variável
area  Campo, Variável, Objeto de formulário in Nome de objeto (se * for especificado) ou Campo ou variável (se * for omitido)
inicioSel  Inteiro longo in Posição inicial da seleção atual de texto
fimSel  Inteiro longo in Posição final da seleção atual de texto

O comando GET HIGHLIGHT permite determinar o texto selecionado atualmente em objeto.

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

Nota: Este comando não pode ser utilizado com campos localizados no formulário listado de um subformulário.

O texto pode ser selecionado pelo usuário ou pelo comando HIGHLIGHT TEXT.

O parâmetro inicioSel retorna a posição do primeiro caractere selecionado.
O parâmetro finalSel retorna a posição do último caractere selecionado mais um.

Se os valores retornados de inicioSel e finalSel são iguais, o usuário não selecionou nenhum texto, e o ponto de inserção está localizado antes do caractere especificado por inicioSel.

Se o objeto designado pelo parâmetro objeto não é encontrado no formulário, o comando devolve -1 em inicioSel e -2 em finalSel.

O exemplo abaixo obtém o texto selecionado no campo [Produtos]Comentarios:

 GET HIGHLIGHT([Produtos]Comentarios;vFirst;vLast)
 If(vFirst<vLast)
    ALERT("O texto selecionado é: "+Substring([Produtos]Comentarios;vPrimerot;vUltimo-vPrimeiro))
 End if

Ver exemplo para o comando FILTER KEYSTROKE.

Modificação do estilo do texto ressaltado:

 GET HIGHLIGHT(*;"meuTexto";$startsel,$endsel)
 OBJECT SET STYLED TEXT ATTRIBUTES(*;"meuTexto";$startsel,$endsel;Attribute underline style;1;Attribute bold style;1)

 
PROPRIEDADES 

Produto: 4D
Tema: Controle de entrada
Número 209

 
HISTÓRIA 

Criado por: < 4D v6
Modificado: 4D v12

 
VER TAMBÉM 

FILTER KEYSTROKE
HIGHLIGHT TEXT
Keystroke

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)

Inherited from : GET HIGHLIGHT ( 4D v12.4)