PowerBuilder L.

Barzi

Eventos de un DataWindows

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.

1 JorgeBarzola@gmail.com
PowerBuilder L.Barzi

Buffers del DataWindows

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.

2 JorgeBarzola@gmail.com
PowerBuilder L.Barzi

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

3 JorgeBarzola@gmail.com