GET HIGHLIGHT
GET HIGHLIGHT ( {* ;} objeto ; inicioSel ; finSel )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| * | Operador | → | Si se especifica, objeto es un nombre de objeto (cadena) Si se omite, objeto es un campo o una variable |
| objeto | Field, Variable, any | → | Nombre del objeto (si se especifica *) o campo o variable (si se omite *) |
| inicioSel | Integer | ← | Posición del inicio de la selección de texto |
| finSel | Integer | ← | Posición del fin de la selección de texto |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando GET HIGHLIGHT permite determinar el texto seleccionado actualmente en objeto.
Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (cadena). Si no pasa el parámetro *, indica que el parámetro objeto es un campo o variable. En este caso, pase la referencia del campo o variable (campos o variables de formulario únicamente) en lugar de una cadena.
Nota: este comando no puede utilizarse con campos ubicados en el formulario listado de un subformulario.
El texto puede ser seleccionado por el usuario o por el comando HIGHLIGHT TEXT.
El parámetro inicioSel devuelve la posición del primer carácter seleccionado.
El parámetro finSel devuelve la posición del último carácter seleccionado más uno.
Si los valores devueltos de inicioSel y finSel son iguales, el usuario no ha seleccionado ningún texto, y el punto de inserción está ubicado antes del carácter especificado por inicioSel.
Si el objeto designado por el parámetro objeto no se encuentra en el formulario, el comando devuelve -1 en inicioSel y -2 en finSel.
Ejemplo 1
El siguiente ejemplo obtiene el texto seleccionado en el campo [Productos]Comentarios:
GET HIGHLIGHT([Productos]Comentarios;vFirst;vLast)
If(vFirst<vlast) alert("el="" texto="" seleccionado="" es:="" "+substring([productos]comentarios;vprimerot;vultimo-vprimero))="" end="" if<="" pre=""></vlast)>
Ejemplo 2
Ver el ejemplo del comando FILTER KEYSTROKE.
Ejemplo 3
Modificación del estilo del texto resaltado:
GET HIGHLIGHT(*;"miTexto";$startsel,$endsel)
ST SET ATTRIBUTES(*;"miTexto";$startsel,$endsel;Attribute underline style;1;Attribute bold style;1)