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âmetro	Tipo		Descrição
rangeObj	Object	->	Objeto intervalo
searchValue	Text	->	Valor da pesquisa
searchCondition	Object	->	Objeto que contém condição(ões) de pesquisa
replaceValue	Text	->	Valor de substituição
Resultados	Object	<-	Objeto intervalo

Descrição

O comando VP Find pesquisa o rangeObj para o searchValue. Podem ser utilizados parâmetros opcionais para refinar a pesquisa e/ou substituir quaisquer resultados encontrados.

In the rangeObj parameter, pass an object containing a range to search.

The searchValue parameter lets you pass the text to search for within the rangeObj.

You can pass the optional searchCondition parameter to specify how the search is performed. As propriedades abaixo são compatíveis:

Propriedade	Tipo	Descrição
afterColumn	Integer	O número da coluna imediatamente anterior à coluna inicial da pesquisa. If the rangeObj is a combined range, the column number given must be from the first range. Valor padrão: -1 (início do rangeObj)
afterRow	Integer	O número da linha imediatamente anterior à linha inicial da pesquisa. If the rangeObj is a combined range, the row number given must be from the first range. Valor padrão: -1 (início do rangeObj)
all	Parâmetros	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. Ex: "a" is the same as "A". vk find flag none no search flags are considered (default) vk find flag use wild cards Wildcard characters (*,?) pode ser usado na string de pesquisa. 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" These flags can be combined. Por exemplo: $search.flags:=vk find flag use wild cards+vk find flag ignore case
order	Integer	vk find order by columns A pesquisa é feita por colunas. Each row of a column is searched before the search continues to the next column. vk find order by rows The search is performed by rows. Each column of a row is searched before the search continues to the next row (default)
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. Por exemplo:$search.target:=vk find target formula+vk find target text

In the optional replaceValue parameter, you can pass text to take the place of any instance of the text in searchValue found in the rangeObj.

Objecto devolvido

A função retorna um objeto de intervalo que descreve cada valor de pesquisa que foi encontrado ou substituído. É devolvido um objeto de intervalo vazio se não forem encontrados resultados.

Exemplo 1

Para encontrar a primeira célula que contém a palavra "Total":

var $range;$result : Object
 
$range:=VP All("ViewProArea")
 
$result:=VP Find($range;"Total")

Exemplo 2

Para encontrar "Total" e substituí-lo por "Total geral":

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
 
  // Replace the cells containing only 'Total' in the current sheet with "Grand Total"


$result:=VP Find($range;"Total";$condition;"Grand Total")
 
  // Check for empty range object 
If($result.ranges.length=0)
    ALERT("No result found")
Else
    ALERT($result.ranges.length+" results found")
End if