Saltar al contenido principal
Versión: Siguiente

ST Get text

ST Get text ( {* ;} objeto {; inicioSel {; finSel}} ) : Text

ParámetroTipoDescripción
*OperadorSi se especifica, objeto es un nombre de objeto (cadena). Si se omite, objeto es una variable o un campo
objetoanyNombre del objeto (si se especifica *) o campo o variable texto (si se omite *)
inicioSelIntegerInicio de la selección
finSelIntegerFin de la selección
ResultadoTextTexto incluyendo las etiquetas de estilo

Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.

Descripción

El comando ST Get text devuelve el texto con estilo encontrado en el campo o variable de texto designado por el parámetro objeto.

Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (cadena). Durante la ejecución, si el objeto tiene el foco, el comando devuelve información sobre el objeto que está siendo editado, sin embargo, cuando el objeto no tiene el foco, el comando devuelve información sobre la fuente de datos (campo o variable) del objeto.
Si omite el parámetro *, indica que el parámetro objeto es un campo o una variable. En este caso, pase una referencia campo o variable en lugar de una cadena y durante la ejecución, el comando devuelve información sobre este campo o variable.

El comando devuelve el texto con las etiquetas de estilo asociadas a él, lo que significa, por ejemplo, que puede copiar y pegar texto mientras conserva su estilo.

Los parámetros opcionales inicioSel y finSel permiten designar una selección de texto en objeto. Los valores de inicioSel y finSel ofrecen una selección de texto sin formato, sin tener en cuenta ningún tipo de etiquetas de estilo en el texto.

  • Si se omite inicioSel y endSel, ST Get text devuelve todo el texto en el objeto,
  • Si pasa inicioSel y finSel, ST Get text devuelve la selección de texto definida por estos límites.

4D ofrece constantes predefinidas para que pueda designar automáticamente los límites de la selección en los parámetros inicioSel y endSel. Estas constantes se encuentran en el tema "Texto multiestilo":

ConstanteTipoValorComentario
ST End highlightEntero largo-1001Designa el último carácter de la selección actual de texto en el objeto (*)
ST End textEntero largo0Designa el último carácter del texto contenido en el objeto
ST Start highlightEntero largo-1000Designa el primer carácter de la selección actual de texto en el objeto (*)
ST Start textEntero largo1Designa el primer carácter del texto contenido en el objeto

(*) Debe pasar un nombre de objeto en objeto para poder utilizar esta constante. Si pasa una referencia a un campo o variable, el comando se aplica a todo el texto del objeto.

Si los valores de inicioSel y finSel son iguales o si inicioSel es mayor que finSel, se devuelve un error.

Variables y conjuntos del sistema

Después de ejecutar este comando, la variable OK toma el valor 1 si no se presenta ningún error; de lo contrario, toma el valor 0. Este es el caso particularmente cuando las etiquetas de estilo no se evalúan correctamente (etiquetas incorrectas o faltantes).

En caso de error, no cambia la variable. Cuando ocurre un error en una variable cuando se está evaluando el texto, 4D transforma el texto en texto plano; como resultado, los caracteres <, > y & se convierten en entidades HTML.

Ver también

ST Get plain text
ST SET TEXT
TEXT TO ARRAY