WP Text range

4D v18

WP Text range


WP Text range ( objRango ; rangoInicio ; rangoFin ) -> Resultado

Parámetro	Tipo	Descripción
objRango	Objeto	Rango o referencia del elemento o documento 4D Write Pro
rangoInicio	Entero largo	Punto inicial del rango de texto
rangoFin	Entero largo	Punto final del rango de texto
Resultado	Objeto	Rango de objeto

Compatibilidad

WP Text range recibió el nombre WP Get range en versiones anteriores de 4D Write Pro. Ha sido renombrado para mayor claridad.

Descripción

El comando WP Text range devuelve un nuevo de rango de selección (objRange) que contiene los caracteres ubicados entre rangoInicio y rangoFin en el área 4D Write Pro wpArea.

Un objeto rango de texto 4D Write Pro se puede utilizar para manejar los atributos de una parte del documento (especialmente con los comandos WP GET ATTRIBUTES y WP SET ATTRIBUTES). Para más información, consulte el párrafo Comandos de gestión de rangos.

Puede pasar en objRango:

un rango, o
un elemento (tabla/ fila / párrafo / imagen en línea/ cuerpo / encabezado / pie / sección / subsección), o
documento 4D Write Pro

Si no se pasa ningún objeto válido en el parámetro objRango, se devuelve un rangeObj vacío.

En rangoInicio y rangoFin, pase los valores correspondientes a la posición de los primeros y últimos caracteres a seleccionar en el documento. Puede pasar wk start text en rangoInicio para definir el comienzo del documento y wk end text en rangoFin para definir el final del documento. Tenga en cuenta que un documento 4D Write Pro no sólo contiene texto visible, sino también las etiquetas de formato que se incluyen en el rango.

Nota: Si pasó una referencia de elemento de tabla, fila, párrafo, imagen en línea, cuerpo, encabezado, pie, sección o subsección en objRango, rangoInicio y rangoFin serán relativos al índice inicial y final del rango del elemento. Por ejemplo, si se pasa un encabezado, wk start text designa el carácter de inicio del encabezado y wk end text el carácter de finalización del encabezado; si se pasa una referencia de elemento de tabla, el comando devolverá el rango de texto relativo a la tabla referenciada por objRango; si se pasa una sección rangoInicio y rangoFin son relativos al cuerpo del documento (área padre de un rango creado de una sección). Ver ejemplo 2.

Ejemplo 1

Usted desea seleccionar un rango de 12 caracteres comenzando desde el principio del campo 4D Write Pro. El campo se muestra en un objeto de formulario:

Si ejecuta:

 $range2:=WP Get range([SAMPLE]WP;wk start text;12)

 WP SELECT(*;"WParea";$range2)

...el resultado es:

Ejemplo 2

Quiere crear un rango de una sección:

 C_OBJECT($wpRange)

 $wpRange:=WP Text range(wpSection;1;11) //devuelve un rango hecho de los primeros 10 caracteres de la sección

  //si sección inicia en 100 en el documento:

  //$wpRange.start = 100

  //$wpRange.end = 111

Ver también

WP Bookmark range
WP Get body
WP Get header
WP Paragraph range
WP Picture range
WP SELECT
WP Selection range
WP Table range