4D Doc Center : PV FIND ONE

4D View v14

PV FIND ONE


PV FIND ONE ( area ; criterio ; donde ; contiene {; columna ; linea} )

Parámetro	Tipo	Descripción
area	Entero largo	Área 4D View
criterio	Cadena	Cadena a buscar
donde	Entero	0 = Fórmulas; 1 = Valores
contiene	Entero	0 = Contiene; 1 = Igual
columna	Entero largo	Número de columna de la celda de inicio
		Número de columna de la celda encontrada
linea	Entero largo	Número de línea de la celda de inicio
		Número de línea de la celda encontrada

Descripción

El comando PV FIND ONE busca criterio entre las celdas del area. La búsqueda se detendrá en la primera celda, si la hay, que cumpla con los criterios de búsqueda.

criterio especifica la cadena a buscar.

donde indica que parte de la hoja de cálculo consultar:

0: búsquedas en las fórmulas
1: búsquedas en los valores

contiene define el tipo de comparación:

0: Parcial (contiene el valor buscado)
1: Total (igual al valor buscado)

Si se omiten los parámetros opcionales columna y linea, la búsqueda comienza en la esquina superior izquierda del area.
Si se pasan columna y linea, indican la celda del area en la que comenzará la búsqueda.
La búsqueda se efectúa de arriba a abajo y de izquierda a derecha, comenzando por la celda indicada.

Después de la ejecución del comando, la primera celda encontrada, se convierte en la nueva celda actual. Si se llaman, los parámetros columna y linea contendrán entonces sus coordenadas.

Si no se encontró ninguna celda durante la búsqueda, la celda actual se mantiene sin cambios.

Ejemplo

Vamos a buscar la primera celda que contiene la respuesta del usuario a una solicitud inicial. Se iniciará la consulta en la celda B3.

 C_STRING(255;$Criteria) `Cadena a buscar

 C_INTEGER($QueryWhere) `0=Fórmulas / 1=Valores

 C_INTEGER($Contains) `0=Igual / 1=Contiene

 C_LONGINT($Column) `Número de columna de la celda encontrada

 C_LONGINT($Row) `Número de la línea de la celda de inicio

 

 $Criteria:=Request("¿Cuál es el valor a buscar?";"x")

 

 If($Criteria#"") `Criterio definido

    CONFIRM("Búsqueda en las fórmulas o en los valores?";"Valores";"Fórmulas")

    $QueryWhere:=OK `0=Fórmulas / 1=Valores

 

    CONFIRM("¿Qué tipo de comparación?";"Contiene";"=")

    $Contains:=OK `0=Contiene / 1=Igual

 

    $Column:=2 `Búsqueda a partir de la celda B3

    $Row:=3

 

    PV FIND ONE(Area;$Criteria;$QueryWhere;$Contains;$Column;$Row) `Búsqueda

 End if