WP Find previous
WP Find previous ( objCible ; rechercherAprès ; rechercherValeur ; conditionRecherche {; remplacerValeur} ) -> Résultat
| Paramètre | Type | Description | |
|---|---|---|---|
| objCible | Objet | 🡒 | Plage ou élément ou document 4D Write Pro |
| rechercherAprès | Objet | 🡒 | Plage avant laquelle la recherche va commencer |
| rechercherValeur | Chaîne | 🡒 | Rechercher la valeur |
| conditionRecherche | Entier long | 🡒 | Règle(s) de recherche |
| remplacerValeur | Chaîne | 🡒 | Chaîne de remplacement |
| Résultat | Objet | 🡐 | Plage de la valeur trouvée/remplacée |
Description
La commande WP Find previous recherche le paramètre objCible, avant la plage rechercherAvant, pour le paramètre rechercherValeur fondé sur conditionRecherche. Un paramètre optionnel peut être utilisé pour remplacer les résultats trouvés.
Note : WP Find previous ne recherche pas ou ne remplace pas le texte dans les formules. Utilisez la commande WP Get formulas dans ce cas.
Dans le paramètre objCible, passez un objet contenant :
- une plage, ou
- un élément (tableau / ligne / cellule(s) / paragraphe / corps / en-tête / pied de page / section / sous-section / zone de texte), ou
- un document 4D Write Pro
Passez une plage dans le paramètre rechercherAvant. La recherche démarrera immédiatement avant la plage définie.
Note : Si objCible est le document 4D Write Pro et rechercherAvant est dans une zone de texte, la commande recherche les occurrences d'abord dans la zone de texte parent, puis dans la ou les zones de texte précédentes, le ou les pieds de page, l'en-tête ou les en-têtes, et finalement le corps par ordre décroissant (selon l'ordre ci-dessous).
Le paramètre rechercherValeur vous permet de passer le texte à rechercher dans objCible.
Vous pouvez spécifier la recherche à effectuer avec le paramètre conditionRecherche. Vous pouvez utiliser une (ou une combinaison) des constantes suivantes :
| Constante | Comment |
|---|---|
| wk case insensitive | Les chaînes sont comparées sans tenir compte des différences de majuscules. A noter que les signes diacritiques sont pris en compte. Par exemple, "A" est considéré comme "a", mais "a" n'est pas considéré comme "à". |
| wk diacritic insensitive | Les chaînes sont comparées mais le signe diacritique (par exemple, l'accent ou le symbole) des lettres est ignoré. Par exemple, "a" est considéré comme "à". |
| wk find reverse | La recherche est effectuée dans l'ordre inverse. |
| wk kana insensitive | Pour la langue japonaise. Les chaînes sont comparées selon le sens (et non le style d'écriture). Par exemple, "あ" est considéré comme "ア". Lorsque cette option est définie, wk width insensitive est implicite (considéré comme défini). Cependant, l'inverse n'est pas vrai. |
| wk keep character style | Lorsque vous remplacez du texte, le style de caractère existant est conservé (si possible). |
| wk override protected | La protection en lecture/écriture est ignorée et les chaînes des zones protégées peuvent être remplacées. |
| wk use keyboard language | Pour la comparaison de chaînes, utilisez la propriété de langue du clavier à partir de l'objet formulaire en cours de modification au lieu de la langue de données actuelle (par défaut). Note : ignorée si le document est hors écran. |
| wk whole word | Seules les chaînes qui sont des mots complets sont prises en compte. Les chaînes correspondantes dans d'autres chaînes ne sont pas prises en compte. Par exemple, "where" n'est pas pris en compte lorsqu'il se trouve dans le mot "somewhere". |
| wk width insensitive | Pour la langue japonaise. Les chaînes sont comparées par largeur de caractère. Par exemple, "ｱ" est considéré comme étant identique à "ア". |
Note : Les chaînes sont comparées au langage de données courant, sauf si wk use keyboard language est utilisé.
Dans le paramètre optionnel remplacerValeur, vous pouvez passer du texte pour remplacer toute instance du texte de rechercherValeur identifiée dans objCible.
Plage retournée
La fonction retourne une plage de la valeur trouvée ou remplacée :
- opérations de recherche - les plages correspondent aux positions des chaînes trouvées
- opérations de remplacement - les plages correspondent aux positions des chaînes remplacées
Si objCible est une plage ou un élément, les valeurs trouvées sont retournées dans l'ordre où elles sont identifiées. Si objCible est un document 4D Write Pro, les valeurs trouvées sont retournées dans l'ordre suivant :
- corps
- en-tête de première page de la section 1 (le cas échéant)
- pied de page de la première page de la section 1 (le cas échéant)
- en-tête de la page de gauche pour la section 1 (le cas échéant)
- pied de la page de gauche pour la section 1 (le cas échéant)
- en-tête de la page de droite pour la section (le cas échéant)
- pied de la page de droite pour la section 1 (le cas échéant)
- en-tête principal de la section 1 (le cas échéant)
- pied de page principal de la section 1 (le cas échéant)
- faire de même avec la section 2, la section 3, et ainsi de suite.
- zones de texte.
Une plage vide est retournée si aucun résultat est trouvé.
Exemple
var $userSel ;$target ;$alphaRanges ;$previousRanges: object
var $options : Integer
// définir les options de recherche
$options:=wk case insensitive+wk diacritic insensitive
// lire la position courante de l'utilisateur
$userSel:=WP Selection range(*;"WParea")
// définir la cible
$target:=WP Get body(WParea) // effectuer la recherche uniquement dans le corps
// lancer la RECHERCHE des PRECEDENTES occurences de la chaîne "alpha" (fondée sur la sélection courante)
$previousRanges:=WP Find previous($target;"alpha";$options)