VP Find

4D v19

VP Find


VP Find ( intervaloObj ; valorPesquisa {; condicaoPesquisa {; substituirValor}} ) -> Resultado

Parâmetro	Tipo	Descrição
intervaloObj	Objeto	Objeto intervalo
valorPesquisa	Texto	valor de pesquisa
condicaoPesquisa	Objeto	Objeto contendo as condições de pesquisa
substituirValor	Texto	Valor de substituição
Resultado	Objeto	Objeto intervalo (range)

Descrição

O comando VP Find procura o intervaloObj pelo valorPesquisa. Os parâmetros opcionais podem ser utilizados para refinar a pesquisa e/ou substituir quaisquer resultados encontrados.

No parâmetro intervaloObj, passar um objecto contendo um intervalo para pesquisar.

O parâmetro valorPesquisa permite passar o texto a pesquisar dentro de intervaloObj.

Pode passar o parâmetro opcional pesquisaCondição para especificar como a pesquisa é efetuada. São compatíveis as seguintes propriedades:

Propriedade Tipo Descrição

afterColumn Longint O número da coluna imediatamente antes da coluna inicial da pesquisa. Se o intervaloObj for um intervalo combinado, o número da coluna dada deve ser do primeiro intervalo. Valor por padrão: -1 (início do intervaloObj)

afterRow Longint O número da fila imediatamente antes da linha inicial da busca. Se o intervaloObj for um intervalo combinado, o número da linha dado deve ser do primeiro intervalo. Valor por padrão: -1 (início do intervaloObj)

all

Boolean

True - Todas as células em intervaloObj correspondente a valorPesquisa são retornadas
False - (padrão) Apenas a primeira célula em intervaloObj correspondente a valorPesquisa é retornado

flags

Longint

Constante	Comentário
vk find flag exact match	Especifica que o conteúdo inteiro da célula deve corresponder completamente com o valor de pesquisa.
vk find flag ignore case	Especifica que as letras maiúsculas e minúsculas são consideradas da mesma maneira. Ex: "a" é a mesma coisa que "A".
vk find flag none	Especifica que no flags de pesquisa sejam consideradas (padrão)
vk find flag use wild cards	Especifica que caracteres coringa (,?) podem ser usados na string de pesquisa. Caracteres coringa podem ser usados em qualquer comparações de frases para corresponder a qualquer número de caracteres - para zero ou caracteres múltiplos. Por exemplo, pesquisar por "bl*" pode achar "bl", "black", "blue" e "blob". ? - Para um caractere único. Por exemplo pesquisar por "h?t" pode achar "hot", "hat" e "hit".

Estas flags podem ser combinadas. Por exemplo:

$search.flags:=vk find flag use wild cards+vk find flag ignore case

order

Longint

Constante	Comentário
vk find order by columns	Especifica que a pesquisa é realizada por colunas. Cada linha de uma coluna é pesquisada antes que a pesquisa continue para a próxima coluna.
vk find order by rows	Especifica que a pesquisa seja realizada por linhas. Cada coluna de uma linha é pesquisada antes que a pesquisa continue para a próxima linha (padrão)

target

Longint

Constante	Comentário
vk find target formula	Especifica que a pesquisa seja realizada na fórmula célula.
vk find target tag	Especifica que a pesquisa seja realizada na tag célula.
vk find target text	Especifica que a pesquisa é realizada no texto de célula (padrão)

Estas flags podem ser combinadas. Por exemplo:

$search.target:=vk find target formula+vk find target text

In O parâmetro opcional subtituirValor, pode passar texto para substituir qualquer instância do texto em valorPesquisa encontrado em intervaloObj.

Objeto retornado

A função retorna um objeto intervalo descrevendo cada valor de pesquisa que foi encontrado ou substituido. Um objeto intervalo vazio é retornado se nenhum resultado for encontrado.

Exemplo 1

Para encontrar a primeira célula contendo a palavra "Total":

 var $range;$result : Object

 

 $range:=VP All("ViewProArea")

 

 $result:=VP Find($range;"Total")

Exemplo 2

Para achar "Total" e substituir com "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

 

  // Substitui as células contendo apenas  'Total' na folha de cálculo atual com "Grand Total"

 $result:=VP Find($range;"Total";$condition;"Grand Total")

 

  // Checa para objetos intervalo vazios

 If($result.ranges.length=0)

    ALERT("No result found")

 Else

    ALERT($result.ranges.length+" results found")

 End if