VP Find

VP Find ( rangeObj : Object ; searchValue : Text ) : Object
VP Find ( rangeObj : Object ; searchValue : Text ; searchCondition : Object ) : Object
VP Find ( rangeObj : Object ; searchValue : Text ; searchCondition : Object ; replaceValue : Text ) : Object

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
searchValue	Text	->	Valeur de recherche
searchCondition	Object	->	Objet contenant la/les condition(s) de recherche
replaceValue	Text	->	Valeur de remplacement
Résultat	Object	<-	Objet plage

Description

La commande VP Find recherche le paramètre rangeObj pour la searchValue. Des paramètres facultatifs peuvent être utilisés pour affiner la recherche et/ou remplacer les résultats trouvés.

Dans le paramètre rangeObj, passez un objet contenant une plage à rechercher.

Le paramètre searchValue vous permet de passer le texte à rechercher dans rangeObj.

Vous pouvez passer le paramètre optionnel searchCondition pour préciser la manière dont la recherche est effectuée. Les propriétés suivantes sont prises en charge :

Propriété	Type	Description
afterColumn	Integer	Le numéro de la colonne située juste avant la colonne de départ de la recherche. If the rangeObj is a combined range, the column number given must be from the first range. Default value: -1 (beginning of the rangeObj)
afterRow	Integer	Le numéro de la colonne située juste avant la colonne de départ de la recherche. Le numéro de la colonne située juste avant la colonne de départ de la recherche. Default value: -1 (beginning of the rangeObj)
all	Boolean	True - All cells in rangeObj corresponding to searchValue are returned False - (default value) Only the first cell in rangeObj corresponding to searchValue is returned
flags	Integer	vk find flag exact match The entire content of the cell must completely match the search value vk find flag ignore case Capital and lower-case letters are considered the same. can be used in the search string. Wildcard characters can be used in any string comparison to match any number of characters: * for zero or multiple characters (for example, searching for "bl*" can find "bl", "black", or "blob") ? for a single character (for example, searching for "h?t" can find "hot", or "hit" vk find flag exact match The entire content of the cell must completely match the search value vk find flag ignore case Capital and lower-case letters are considered the same.Ex : "a" est la même chose que "A". These flags can be combined. For example: $search.flags:=vk find flag use wild cards+vk find flag ignore case order Integer vk find order by columns The search is performed by columns. Each column of a row is searched before the search continues to the next row (default) vk find order by columns The search is performed by columns.Chaque ligne d'une colonne est recherchée avant que la recherche ne passe à la colonne suivante. target Integer vk find target formula The search is performed in the cell formula vk find target tag The search is performed in the cell tag vk find target text The search is performed in the cell text (default) These flags can be combined. Par exemple ::$search.target:=vk find target formula+vk find target text Dans le paramètre optionnel replaceValue, vous pouvez passer du texte pour remplacer toute instance du texte dans la searchValue trouvée dans rangeObj. Objet retourné La fonction retourne un objet de plage décrivant chaque valeur de recherche trouvée ou remplacée. Un objet de plage vide est retourné si aucun résultat n'est trouvé. Exemple 1 Pour trouver la première cellule contenant le mot "Total" : var $range;$result : Object $range:=VP All("ViewProArea") $result:=VP Find($range;"Total") Exemple 2 Pour trouver "Total" et le remplacer par "Grand Total" : var $range;$condition;$result : Object $range:=VP All("ViewProArea") $condition:=New object $condition.target:=vk find target text $condition.all:=True //Search entire document $condition.flags:=vk find flag exact match // Remplacer les cellules contenant uniquement 'Total' dans la feuille actuelle par "Grand Total". $result:=VP Find($range;"Total";$condition;"Grand Total") // Vérifier si l'objet de plage est vide If($result.ranges.length=0) ALERT("No result found") Else ALERT($result.ranges.length+" results found") End if