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:
var $wpRange : Object
$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