WP Find all
WP Find all ( objTarget ; buscarValor ; condicionBusq {; valorReempl} ) -> Resultado
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| objTarget | Object | → | Rango o elemento o documento 4D Write Pro |
| buscarValor | Text | → | Valor a buscar |
| condicionBusq | Integer | → | Regla(s) de búsqueda |
| valorReempl | Text | → | 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:  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")