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
Parámetros | Tipo | Descripción | ||
---|---|---|---|---|
rangeObj | Object | -> | Objeto rango | |
searchValue | Text | -> | Valor de búsqueda | |
searchCondition | Object | -> | Objeto que contiene la(s) condición(es) de búsqueda | |
replaceValue | Text | -> | Valor de reemplazo | |
Result | Object | <- | Objeto rango |
Descripción
El comando VP Find
busca en el rangeObj el searchValue. Se pueden utilizar parámetros opcionales para afinar la búsqueda y/o sustituir los resultados encontrados.
En el parámetro rangeObj, pase un objeto que contenga un rango a buscar.
El parámetro searchValue permite pasar el texto a buscar dentro del rangeObj.
Puede pasar el parámetro opcional searchCondition para especificar el funcionamiento de la búsqueda. Se soportan las siguientes propiedades:
Propiedad | Tipo | Descripción | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
afterColumn | Integer | El número de la columna justo antes de la columna inicial de la búsqueda. Si rangeObj es un rango combinado, el número de columna indicado debe ser del primer rango. Valor por defecto: -1 (inicio de rangeObj) | ||||||||
afterRow | Integer | El número de la línea justo antes de la línea inicial de la búsqueda. Si rangeObj es un rango combinado, el número de línea indicado debe ser del primer rango. Valor por defecto: -1 (inicio de rangeObj) | ||||||||
all | Boolean | |||||||||
flags | Integer |
$search.flags:=vk find flag use wild cards+vk find flag ignore case | ||||||||
order | Integer |
| ||||||||
target | Integer |
Estas banderas pueden combinarse. Por ejemplo: |
En el parámetro opcional replaceValue, puede pasar un texto para que ocupe el lugar de toda instancia del texto en el searchValue encontrado en rangeObj.
Objeto devuelto
La función devuelve un objeto de rango que describe cada valor de búsqueda encontrado o reemplazado. Se devuelve un objeto de rango vacío si no se encuentran resultados.
Ejemplo 1
Para encontrar la primera celda que contenga la palabra "Total":
var $range;$result : Object
$range:=VP All("ViewProArea")
$result:=VP Find($range;"Total")
Ejemplo 2
Para encontrar "Total" y reemplazarlo por "Grand Total":
var $range;$condition;$result : Object
$range:=VP All("ViewProArea")
$condition:=New object
$condition.target:=vk find target text
$condition.all:=True //Buscar en todo el documento
$condition.flags:=vk find flag exact match
// Reemplazar las celdas que contienen sólo "Total" en la hoja actual con "Grand Total"
$result:=VP Find($range;"Total";$condition;"Grand Total")
// Comprobar si el objeto de rango está vacío
If($result.ranges.length=0)
ALERT("No result found")
Else
ALERT($result.ranges.length+" results found")
End if