WP Find previous
WP Find previous ( objTarget ; buscarAntes ; buscarValor ; buscarCondicion {; remplazarValor} ) -> Resultado
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| objTarget | Objeto | 🡒 | Rango o elemento o documento 4D Write Pro |
| buscarAntes | Objeto | 🡒 | Rango antes del cual comenzar la búsqueda |
| buscarValor | Cadena | 🡒 | Buscar valor |
| buscarCondicion | Entero largo | 🡒 | Regla(s) de búsqueda |
| remplazarValor | Cadena | 🡒 | Cadena de reemplazo |
| Resultado | Objeto | 🡐 | Rango del valor encontrado/reemplazado |
Descripción
El comando WP Find previous busca el objTarget, antes del rango buscarAntes, para buscarValor basado en condicionBusq. Se puede utilizar un parámetro opcional para reemplazar los resultados encontrados.
Nota: WP Find previous no busca ni reemplaza el 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 / cabecera / pie de página / sección / subsección), o
- un documento de 4D Write Pro.
Pase un rango en el parámetro buscarAntes. La búsqueda comenzará inmediatamente antes del rango definido.
Nota: si objTarget es el documento 4D Write Pro y buscarAntes está en una caja de texto, el comando busca primero en la caja de texto padre y después en la(s) caja(s) de texto anterior(es), pie(s) de página, encabezado(s), y finalmente en el cuerpo en orden descendente (de acuerdo con la ordenación de abajo).
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 buscarCondicion. 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, se puede pasar un texto para que ocupe el lugar de cualquier instancia del texto en buscarValor que se encuentre en el objTarget.
Rango devuelto
La función devuelve un rango del 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 existe)
- 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 lo 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
Se devuelve un rango vacío si no se encuentran resultados.
Ejemplo
var $userSel ;$target ;$alphaRanges ;$previousRanges: object
var $options : Integer
// definir las 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 ocurrencias ANTERIORES de la cadena "alpha" (basada en la selección actual)
$previousRanges:=WP Find previous($target;"alpha";$options)