DBEDIT()*
Despliega registros en una tabla
Syntax
DBEDIT( [<nSup>], [<nIzq>], [<nInf>], [<nDer>], [<acColumnas>], ;
[<xFuncionUsuario>], [<xColumnSayPictures>], [<xCabeceraColumna>], ;
[<xSeparadorCabecera>], [<xSeparadorColumna>], ;
[<xSeparadorPie>], [<xPieColumna>] ) --> lExito
Arguments
<nSup> coordenada para la fila Superior de visualización. El rango para
<nSup> va de cero a MAXROW(), por defecto es cero.
<nIzq> coordenada para la columna izquierda de visualización. El rango para
<nIzq> va de cero a MAXCOL(), por defecto es cero.
<nInf> coordenada para la fila inferior de visualización. El rango para
<nInf> va de cero a MAXROW(), por defecto es MAXROW().
<nDer> coordenada para la columna derecha de visualización. El rango para
<nDer> va de cero a MAXCOL(), por defecto es MAXCOL().
<acColumnas> es un array de expresiones de caracteres que contienen los
nombres de los campos de la base de datos,o expresiones para la visualización en
cada columna. Si no es especificada, por defecto es la visualización de todos los
campos de la base de datos en el area de trabajo actual.
<xFuncionUsuario> es el nombre de una función ó un bloque de codigo que
podría ser llamado cada vez que una tecla no reconocida ha sido presionada ó
cuando no hay más teclas para ser procesadas y DBEDIT() va al modo inactivo. Si
<xFuncionUsuario> es una cadena de caracteres, esta debe contener el nombre de una
función de usuario definida, que sea válida y sin paréntesis. Ambos la función
definida por el usuario ó el bloque de código deberán aceptar dos parámetros: nModo
y nActualColumna. Ambos deberían devolver un valor numérico que corresponda a uno
de los códigos de retorno esperados. (Vea la tabla más abajo con la lista de nModo
y los códigos de retorno)
<xColumnSayPictures> es un molde (picture) opcional. Si <xColumnSayPictures>
es una cadena de caracteres, todas las columnas pueden usar el mismo valor como
cadena de molde (picture). Si <xColumnSayPictures> es un array, cada elemento debe
ser una cadena de caracteres que corresponde a la cadena (picture) usada de molde
para la columna con el mismo índice. Vea la ayuda para @...SAY para tener más
información acreca de los valores de molde (picture).
<xCabeceraColumna> contiene los titulos de cabecera para cada columna si
este es una cadena de caracteres, todas las columnas tendrán el mismo encabezado,
si este es un array, cada elemento es una cadena de caracteres que contienen el
titulo de cabecera para cada campo. La cabecera puede ser dividido en más de una
linea al poner un punto y coma (;) en los lugares donde Ud. desea romper la linea.
Si es omitida el valor por defecto para cada cabecera de columna es tomado de
<acColumnas> ó el nombre del campo de la base de datos, si <acColumnas> no fue
especificado
<xSeparadorCabecera> es un array que contiene caracteres que dibujan las
lineas que separan las cabeceras y los datos de los campos . En lugar de un array
Ud. puede usar una cadena de caracteres que podría ser usada para la visualización
de la misma linea para todos los campos. El valor por defecto es una linea doble.
<xSeparadorColumna> es un array que contiene caracteres que dibujan las
lineas que separan las columnas visualizadas. En lugar de un array Ud. puede usar
una cadena de caracteres que podria ser usada para la visualización de la misma
linea para todos los campos. El valor por defecto es una linea simple.
<xSeparadorPie> es un array que contiene caracteres que dibujan las lineas
que separan el area de datos de los campos y el pie. En lugar de un array Ud.
puede usar una cadena de caracteres que podría ser usada para la visualización de
la misma linea para todos los campos. El valor por defecto es ningún separador de
pie.
<xPieColumna> contiene el pie para ser visualizado al final de cada columna,
si este es una cadena de caracteres, todas las columnas tendran el mismo pie, si
este es un array, cada elemento es una cadena de caracteres que contienen el pie
para cada campo. El pie puede ser dividido en más de una linea al poner un punto y
coma (;) en los lugares donde Ud. desea romper la linea. Si es omitido ningun pie
es visualizado.
Returns
DBEDIT() retorna .F. si no hay una base de datos abierta en ese area de
trabajo, ó si el número de columnas para la visualización es cero, en caso
contrario DBEDIT() devuelve .T.
Description
DBEDIT() visualiza y permite editar registros de una ó más areas de trabajo
en una grilla en pantalla. Cada columna es definida por los elementos de
<acColumnas> y es el equivalente de un campo. Cada fila es el equivalente de un
registro de la base de datos.
A Continuación estan las teclas manejadas por DBEDIT():
-------------------------------------------------------<table> Tecla
Cuando <xFuncionUsuario> es omitida, dos teclas más estan activas: <table>
Tecla significado
Cuando DBEDIT() ejecuta <xFuncionUsuario> le pasa los siguientes argumentos:
nModo y el índice del registro actual en <acColumnas>. Si <acColumnas> es omitido,
el número de índice es número de FIELD() de la estructura de la base de datos
abierta.
Valores de los Modos en DBEDIT() :
---------------------------------<table> Dbedit.ch Valor Significado
DE_EXCEPT
La función definida por el usuario ó el bloque de código debe retornar un
valor que le indique a DBEDIT() que hacer a continuación.
Codigos de retorno de la Función del Usuario:
--------------------------------------------
La función del usuario es llamada una vez en cada uno de los siguientes
casos: - La base de datos esta vacía. - El usuario trata de mover más alla de la
parte superior ó de la parte inferior del archivo. - Interrupción de teclado, el
usuario ha presionado una tecla que no puede ser manejada por DBEDIT(). - El
buffer de teclado esta vacío ó un refresco de pantalla acaba de ocurrir.
Nota Importante: ---------------DBEDIT() es una función de compatibilidad,
esta fué superada por la clase TBrowse y no es recomendada para nuevas
aplicaciones.
Examples
// Despliega un archivo DBF usando valores por defecto
USE Test
DBEDIT()
Status
Started
Compliance
<xFuncionUsuario> puede ser también un bloque de código, esta es una
extensión de Harbour.
CA-Clipper lanzará un error si no hay una base de datos abierta Harbour puede
retornar .F.
Clipper es inconsistente y lanzará un error si el número de columnas es cero.
Harbour puede retornar .F. Las NG de CA-Clipper 5.2 indican que el valor devuelto
es NIL, esto es erróneo y debería ser un valor lógico.
Hay un código de retorno (3) indocumentado para las funciones definidas por
el usuario en Clipper (ambos 87 and 5.x). este es un Modo de agregado (Append) el
cual: "Divide la pantalla para permitir más que datos sean agregados en el area de
la ventana". Este modo no es soportado por Harbour.
Files
Los archivos de cabecera son dbedit.ch, inkey.ch La librería es rtl
