WP Find all

4D v20 R7

WP Find all


WP Find all ( objTarget ; buscarValor ; condicionBusq {; valorReempl} ) -> Resultado

Parámetro	Tipo	Descripción
objTarget	Objeto	Rango o elemento o documento 4D Write Pro
buscarValor	Cadena	Valor a buscar
condicionBusq	Entero largo	Regla(s) de búsqueda
valorReempl	Cadena	Cadena a reemplazar
Resultado	Collection	Colección de objetos de rango

Descripción

El comando WP Find all busca en objTarget después del rango buscarValor basado en la condicionBusq. Se puede utilizar un parámetro opcional para reemplazar los resultados encontrados.

Nota: WP Find all no busca ni reemplaza texto en fórmulas. Utilice el comando WP Get formulas en este caso.

En el parámetro objTarget, pase un objeto que contenga:

un rango, o
un elemento (tabla / fila / celda(s) / párrafo / cuerpo / encabezado / pie de página / sección / subsección / caja de texto), o
un documento de 4D Write Pro.

El parámetro buscarValor permite pasar el texto a buscar dentro del objTarget.

Puede especificar cómo se realiza la búsqueda con el parámetro condicionBusq. Puede utilizar una (o una combinación) de las siguientes constantes:

Constante	Comentario
wk case insensitive	Las cadenas se comparan sin tener en cuenta las diferencias de mayúsculas y minúsculas. Tenga en cuenta que se tienen en cuenta los signos diacríticos. Por ejemplo, "A" se considera igual que "a", pero "a" no se considera igual que "à".
wk diacritic insensitive	Las cadenas se comparan, pero la marca diacrítica (por ejemplo, el acento o el símbolo) de las letras se ignora. Por ejemplo, "a" se considera igual que "à".
wk find reverse	La búsqueda se realiza en orden inverso.
wk kana insensitive	Para el idioma japonés. Las cadenas se comparan según el significado (no el estilo de escritura). Por ejemplo, "あ" se considera igual que "ア". Cuando se define esta opción, wk width insensitive está implícito (se considera definido), sin embargo, lo contrario no es cierto.
wk keep character style	Al reemplazar el texto, se mantiene el estilo de caracteres existente (si es posible).
wk override protected	La protección de lectura/escritura se ignora y las cadenas en áreas protegidas pueden ser reemplazadas.
wk use keyboard language	Para la comparación de cadenas, utilice la propiedad de idioma del teclado del objeto formulario que se está editando en lugar del idioma de los datos actuales (por defecto). Nota: se ignora si el documento está fuera de la pantalla.
wk whole word	Sólo se consideran las cadenas que son palabras completas. No se tienen en cuenta las cadenas que coinciden con otras cadenas. Por ejemplo, "where" no se considera cuando se encuentra dentro de "somewhere".
wk width insensitive	Para el idioma japonés. Las cadenas se comparan por la anchura de los caracteres. Por ejemplo, "ｱ" se considera igual que "ア".

Nota: las cadenas se comparan con el lenguaje de datos actual a menos que se utilice wk use keyboard language.

En el parámetro opcional remplazarValor puede pasar un texto para que tome el lugar de toda instancia de texto en buscarValor que se encuentre en el objTarget.

Colección devuelta

La función devuelve una colección de rango de objetos que describen cada valor encontrado o reemplazado:

operaciones de búsqueda - los rangos coinciden con las posiciones de las cadenas encontradas
operaciones de reemplazo - los rangos coinciden con las posiciones de las cadenas reemplazadas

Si objTarget es un rango o elemento, los valores encontrados se devuelven en el orden en que se encuentran. Si objTarget es un documento 4D Write Pro, los valores encontrados se devuelven en el siguiente orden:

cuerpo
encabezado de la primera página de la sección 1 (si la hay)
pie de página de la sección 1 (si lo hay)
encabezado de la página izquierda de la sección 1 (si lo hay)
pie de página izquierdo de la sección 1 (si lo hay)
encabezado de la página derecha para la sección (si la hay)
pie de página derecho para la sección 1 (si lo hay)
encabezado principal de la sección 1 (si lo hay)
pie de página principal para la sección 1 (si la hay)
repetir con la sección 2, la sección 3, y así sucesivamente.
cajas de texto.

El orden se invierte si se utiliza wk find reverse.

Se devuelve una colección vacía si no se encuentran resultados.

Ejemplo

 var $userSel ;$target ;$alphaRanges : Object

 var $bravoRanges: &NBSP;Collection

 var $options : Integer

 

  // definir opciones de búsqueda

 $options:=wk case insensitive+wk diacritic insensitive

 

  // obtener la posición actual del usuario

 $userSel:=WP Selection range(*;"WParea")

 

  //  definir el objetivo

 $target:=WP Get body(WParea) // buscar sólo dentro del cuerpo

 

  //lanzar la BÚSQUEDA de TODAS las ocurrencias de "alpha" por "bravo" en el cuerpo

 $bravoRanges:=WP Find all($target;"alpha";$options;"bravo")

Ver también

WP Find next
WP Find previous