4D Doc Center : PV REPLACE ONE

4D View v14

PV REPLACE ONE


PV REPLACE ONE ( area ; cadeia ; substituiçao ; onde ; contem {; coluna ; linha} )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Área 4D View
cadeia	cadeia	Cadeia a substituir
substituiçao	cadeia	Cadeia de substituição
onde	Inteiro	0 = Fórmulas; 1 = Valores
contem	Inteiro	0 = Contém; 1 = Igual
coluna	Inteiro longo	Número de coluna da célula de inicio
		Número de coluna da célula encontrada
linha	Inteiro longo	Número de linha da célula de inicio
		Número de linha da célula encontrada

Descrição

O comando PV REPLACE ONE substitui a cadeia de caracteres cadeia pela cadeia substituir na primeira célula na area que corresponde aos critérios de pesquisa definidos utilizando onde ou contem, a partir da célula definida linha e coluna.

cadeia especifica a cadeia de caracteres a buscar e substituir por substituir.

onde indica que parte da folha de cálculo consultar:

0: pesquisas nas fórmulas
1: pesquisa nos valores

contem define o tipo de comparação:

0: Parcial (contém o valor buscado)
1: Total (igual ao valor buscado)

Se omitidos os parâmetros opcionais coluna e linha, a pesquisa começa na esquina superior esquerda da area. Se passar coluna e linha, indicam a célula da area na que começará a pesquisa.
A pesquisa se realiza de cima a abaixo e de esquerda a direita começando com a célula de inicio.

Depois da execução do comando, a primeira célula encontrada, se converte na nova célula atual. Se chamarão, os parâmetros coluna e linha irão conter então as coordenadas desta nova célula.

Se não se encontrou nenhuma célula durante a pesquisa, a célula atual se mantém sem mudanças.

Exemplo

Substituímos a primeira ocorrência da referencia a taxa do T.V.A. com uma nova referencia (nova taxa).

 C_INTEGER($Where) `0=Fórmula / 1=Valor

 C_INTEGER($Contem) `0=Contém / 1=Igual

 

 $Where:=0 `Substituição de fórmula

 $Contem:=0 `Contém

 

  `Substituição da primeira ocorrência

 PV REPLACE ONE(Area;"$C$30";"$C$31";$Where;$Contem)