WP Create range

4D v17

WP Create range


WP Create 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 Create 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 Create 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
una referencia de elemento (tabla/ fila / párrafo / imagen en línea/ cuerpo / encabezado / pie), 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.

Si pasó una referencia de elemento de tabla, fila, párrafo, imagen en línea, cuerpo, encabezado 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 de la tabla a la que hace referencia la tabla.

Nota: si pasó una referencia de elemento en objRango, recuerde que el rango devuelto es relativo al contenido del texto del cuerpo, encabezado o pie. El objeto rango mantiene una referencia interna al cuerpo, encabezado o pie de página principal.

Ejemplo

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:

Ver también

WP Get body
WP Get bookmark range
WP Get header
WP Get selection
WP SELECT