4D v19WP Find all |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v19
WP Find all
|
WP Find all ( objCible ; rechercherValeur ; conditionRecherche {; remplacerValeur} ) -> Résultat | ||||||||
Paramètre | Type | Description | ||||||
objCible | Objet |
![]() |
Plage ou élément ou document 4D Write Pro | |||||
rechercherValeur | Chaîne |
![]() |
Rechercher une valeur | |||||
conditionRecherche | Entier long |
![]() |
Règle(s) de recherche | |||||
remplacerValeur | Chaîne |
![]() |
Chaîne de remplacement | |||||
Résultat | Collection |
![]() |
Collection d'objets plage | |||||
La commande WP Find all recherche le paramètre objCible fondé sur conditionRecherche. Un paramètre optionnel peut être utilisé pour remplacer les résultats trouvés.
Note : WP Find all 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), ou
un document 4D Write Pro
Le paramètre conditionRecherche 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 dans rechercherValeur identifiée dans objCible.
Collection retournée
La fonction retourne une collection d'objets plage décrivant chaque valeur trouvée ou remplacée :
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 :
L'ordre est inversé si wk find reverse est utilisé.
Une collection vide est retournée si aucun résultat est tourné.
var $userSel ;$target ;$alphaRanges ;$bravoRanges : object
var $options : Integer
// définir les options de recherche
$options:=wk case insensitive+wk diacritic insensitive
// obtenir les positions courantes 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 le REMPLACEMENT de TOUTES les occurences de "alpha" par "bravo" dans le corps
$bravoRanges:=WP Find all($target;"alpha";$options;"bravo")</p><p>
Produit : 4D
Thème : 4D Write Pro - Langage
Numéro :
1755
Créé : 4D v19
4D Write Pro ( 4D v19)