Sei sulla pagina 1di 3

Powe rBuilde r

Eventos de un DataWindows

L.Ba rzi

Evento

Descripción

Clicked

El usuario ejecuta un click con el ratón.

Constructor

Este evento está presente en casi todos los objetos de PowerBuilder. Se ejecuta cuando el sistema acaba de crear el objeto.

DbError

Ha ocurrido un error de base de datos. Util para capturar errores de la base de datos y tratarlos según nuestro criterio.

Destructor

El sistema destruye los objetos, normalmente al cerrar una ventana.

EditChanged:

Cada vez que el usuario pulsa una tecla y modifica un carácter del contenido de un campo.

Error

Se produce un error de validación en un campo.

ItemChanged

El usuario ha modificado un campo e intenta cambiar de campo con la tecla tab o el mouse. Util para validar los datos, ya que nos da la oportunidad de rechazar lo que el usuario ha introducido.

ItemError

El usuario ha producido un itemchanged pero los datos que contiene el campo no pasan las reglas de validación introducidas en el datawindow object.

ItemFocusChanged

El usuario cambia de campo.

RetrieveEnd

Ha finalizado una instrucción retrieve (consulta a la base de datos).

RetrieveRow

Mientras se está ejecutando una instrucción retrieve y recuperamos cada una de las filas.

RetrieveStart

Antes de que se lance la instrucción SQL Select contra la base de datos.

RowFocusChanged

El foco cambia de fila. Cuidado con esta instrucción porque se ejecuta por sí sola cuando hacemos un insert, un delete o un retrieve.

SqlPreview

Cada vez que ejecutamos funciones de PowerBuilder que afectan a la base de datos.

Retrieve

Update, etc. Muy útil para depurar el sql que se está generando.

UpdateEnd

Ha finalizado la actualización de la base de datos.

UpdateStart

Antes de que empiece la actualización de la base de datos.

Powe rBuilde r

Buffers del DataWindows

L.Ba rzi

Buffers

Descripción

Primary!

Es el buffer por defecto. El que el usuario modifica con el teclado.

Original!

Es el buffer que guarda los datos tal y como se recuperaron de la base de datos.

Deleted!

Guarda las filas borradas.

Filtered!

Cuando aplicamos un filtro al DataWindow, aquí se almacenan las filas que no se ven, y que han desaparecido del buffer Primary!

Ejemplo del uso de buffers:

Cuando un usuario borra una fila, ésta no desaparece de la memoria, sino que simplemente se mueve del buffer Primary al Deleted. Así que si queremos, podemos recuperarla sin acceder a la base de datos.

Funciones del DataWindow

Funcion

Descripción

AcceptText

Provoca la validación del campo actual si el usuario no pulsó tab.

DBCancel

Provoca la cancelación de un Retrieve( ) en curso.

DeletedCount

Devuelve el número de filas que el usuario ha borrado.

DeleteRow

Borra una fila.

Describe

Devuelve información muy detallada sobre la estructura del DataWindow.

Filter

Ejecuta el filtro actual (véase setFilter).

GetChild

Devuelve un apuntador a un DataWindow contenida dentro de otra.

GetColumn

Devuelve el número de columna actual.

GetColumnName

Devuelve el nombre de la columna actual.

GetItemxxx

xxx representa un tipo de dato. Devuelve el valor contenido en una columna.

GetItemStatus

Devuelve el status de una fila o columna.

GetRow

Devuelve el número de fila actual.

GetSQLSelect

Devuelve la select del DataWindow.

GetText

Devuelve un string que contiene el valor de una columna que está siendo editada antes de que el usuario la confirme cambiando de campo.

Powe rBuilde r

L.Ba rzi

GetValue

Devuelve un string conteniendo el valor de una columna.

InserRow

Inserta una fila en blanco.

Modify

Modifica la estructura interna de un DataWindow.

Print

Imprime un DataWindow

Retrieve

Ejecuta una select contra la base de datos y muestra los datos en el DataWindow.

RowCount

Cuenta las filas en un DataWindow.

SaveAs

Salva el contenido de un DataWindow en un fichero. Soporta diversos formatos incluyendo excel, texto, rtf y html.

ScrollToRow

Scrollea el DataWindow hasta una fila y la hace visible (no confundir con setRow()).

SetColumn

Cambia el foco a una columna en concreto.

SetFilter

Modifica las condiciones de filtro de un DataWindow.

SetFocus

Coloca el foco en un DataWindow.

SetItem

Modifica el valor de una columna.

SetItemStatus

Modifica el status de una fila o columna.

SetRow

Hace que la fila especificada sea la actual.

SetSort

Modifica las condiciones de ordenador.

SetTransObject

Enlaza un DataWindow con el objeto Transacción. Para que un DataWindow funcione es imprescindible ejecutar la siguiente instrucción:

Nombre_del_DataWindow.SetTransObject(SQLCA)

ShareData

Hace que un DataWindow comparta datos con otra (se puede conseguir un efecto de espejo).

Sort

Ordena un DataWindow con las condiciones especificadas con SetSort().

Update

Graba las modificaciones en la base de datos