WP Chercher suivant

4D v19

WP Chercher suivant


WP Chercher suivant ( 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 après laquelle la recherche va démarrer
rechercherValeur	Chaîne	Rechercher une 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 Chercher suivant recherche le paramètre objCible, après la plage rechercherAprès, pour le paramètre rechercherValeur fondé sur conditionRecherche. Un paramètre optionnel peut être utilisé pour remplacer les résultats trouvés.

Note : WP Chercher suivant ne recherche pas ou ne remplace pas le texte dans les formules. Utilisez la commande WP Lire formules 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), ou
un document 4D Write Pro

Passez une plage dans le paramètre rechercherAprès. La recherche démarrera immédiatement après la plage définie ou bien passez NULL pour identifier la première valeur de objCible.

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
wk diacritic insensitive
wk find reverse
wk kana insensitive
wk keep character style
wk override protected
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.

Une plage vide est retournée si aucun résultat est trouvé.

Exemple

 var $userSel ;$target ;$alphaRanges ;$nextRanges: 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 Plage selection(*;"WParea")

 

  // définir la cible

 $target:=WP Lire corps(WParea) // effectuer la recherche uniquement dans le corps

 

  // lancer la RECHERCHE des PROCHAINES occurences de la chaîne "alpha" (fondée sur la sélection courante)

 $previousRanges:=WP Chercher suivant($target;$userSel;"alpha";$options)

Voir aussi

WP Chercher précédent
WP Chercher tous