EL CONTROL DATAWINDOW

Permite la visualizacin de los datos en la ventana que sirve de interfaz para el

usuario. El objeto datawindows en si no es de ninguna utilidad, si no se vincula
con un objeto Datawindow control. Este objeto, es visual y es posible de insertar
directamente en una ventana; para que pueda ser utilizado por el usuario. Tiene
un grupo de propiedades y funciones que permiten al programador un manejo
eficiente de los datos.

Un control datawindow, como todo control, va pegado en una ventana. Se

acostumbra darle nombre empezando por dw_

A continuacin se listan las propiedades particulares que el objeto posee.

Propiedad Descripcin

Name Es el nombre que tendr el objeto Datawindow Control.

Dataobject Seleccione el nombre del objeto Datawindow que ser mostrado en

este Datawindow control.

Title Escriba el texto que aparecer en la barra de titulo, si esta marcada

la opcin TitleBar.

TitleBar Si esta opcin esta marcada, el texto que este en la caja Title se
mostrara como una barra de titulo.

Control Menu Si esta opcin est marcada, permite que el Datawindow Control,
sea un objeto flotante (pudiendo moverse) dentro de los limites de la
ventana que lo contiene.

Maximize box Permite que el Datawindow control, presente los botones

Maximizar y Minimizar, respectivamente.
Minimize box

Eventos del Control Datawindow

El Objeto Datawindow Control tambin posee eventos, los ms comunes son los
siguientes:

Facultad de Ingeniera Ing. Ana Doris M. Barrera Loza

 Evento Descripcin

RowFocusChanged Sucede cuando el foco cambia de un registro a otro, no de un

campo a otro dentro del mismo registro.Tambin sucede
cuando se obtienen datos (Retrieve) de la Base de Datos.

ItemChanged Ocurre cuando el usuario un campo ha sido modificado y este

campo pierde el foco (presionar tecla Enter, tecla Tab, o
moviendose a otro campo cualquiera)Tambien ocurre cuando
se utiliza la funcin AccepText o la funcin Update.

OBJETO TRANSACCION
Un objeto de transaccin es un objeto de PowerBuilder, y cumple la funcin de
intermediario entre la aplicacin en si, y el administrador de Base de Datos.
Cuando se hace una nueva aplicacin, se genera un objeto de transaccin por
defecto. Su nombre es SQLCA.

Para hacer uso del Datawindow Control en tiempo de ejecucin es necesario

indicar que objeto de transaccin ser utilizado por el Datawindow para
presentar la informacin definida en el.

Esto se hace, con la siguiente funcin:

<nom Dw>.SetTransObject(<obj transac>)

Donde:

<nom Dw> es el nombre del Datawindow Control.

<obj transac> es el objeto de transaccin, por defecto utilice SQLCA.

Esta sentencia debe escribirse antes de hacer uso del Datawindow Control,
normalmente se pone en el Evento "Open" de la ventana que contiene al
Datawindow Control.

Ej. dw_inicio.SetTransObject(sqlca)

Para obtener datos de la Base de Datos, y mostrarlos en el Datawindow Control,

se utiliza la siguiente funcin:

Facultad de Ingeniera Ing. Ana Doris M. Barrera Loza

 <nom Dw>.Retrieve (<lista parametros>)

Donde:

<nom Dw> es el nombre del Datawindow Control.

< lista parametros >, si para el Origen de Datos (del Datawindow), se

definieron argumentos, deben listarse los valores a utilizar por cada uno
en el mismo orden en que fueron definidos y separados entre si por una
coma. Los argumentos se escriben como literales, sin comillas para los
argumentos de tipo texto.

Ej. dw_nuevo.Retrieve( Contabilidad, sle_edad.text )

Normalmente, primero se pega un datawindow control en la ventana, y despus

le asignas un datawindow object que se ha creado antes. Pero tambin se puede
hacer sto dinmicamente a travs de un script. El atributo DataObject es el que
asigna la propiedad Data Object al datawindow, es decir, para modificar en
tiempo de ejecucin el datawindow que esta vinculado al Datawindow Control,
utilice la siguiente funcin:

<nom Dw>.DataObject = <nombre obj Dw>)

Donde:

<nom Dw> es el nombre del Datawindow Control.

< nombre obj Dw >, es el nombre de un objeto Datawindow definido.

Es necesario nuevamente, indicar el objeto de transaccin que se
utilizara para este Datawindow y volver a ocupar la funcin
Retrieve, para obtener los datos de este nuevo Datawindow.

Ej. dw_nuevo.DataObject= d_otro

Creacin de un Control DataWindow

Para crear un control datawindow y asociarlo con un objeto datawindow, seguir
los siguientes pasos:

Facultad de Ingeniera Ing. Ana Doris M. Barrera Loza

 Crear una nueva ventana (window).

Seleccionar de la barra de herramientas el control datawindow. Pegar el

control en la ventana, dndole el tamao que se estime va a tener el
datawindow que se desea mostrar. Llamarlo dw_1.

Asociar el control datawindow al objeto datawindow anteriormente creado.

Para ello, dar doble click sobre el control datawindow y aparecer la
ventana de propiedades en la que en la propiedad DataObject,
seleccionaremos el nombre del objeto datawindow con el que se quiere
asociar.

Utilizar un Objeto Transaccin. En el script de la ventana, en la que se

encuentra el control datawindow en el evento open, escribir el siguiente
cdigo:

dw_1.settransobject(sqlca)
dw_1.retrieve( )

Si la aplicacin no tiene cdigo para CONEXION a base de datos, presionar

el botn Db Profile, presionar Edit, ir a la hoja Preview, presionar Copy
para copiar el cdigo de la conexin. Cerrar la ventana Db Profile. Ir a la
aplicacin y pegar el cdigo. A continuacin escribir lo siguiente:

Connect; sirve para hacer la conexin

Open (nombre de la ventana principal)

CODIGO DE CONEXION
Para conectarse a una Base de Datos desde una aplicacin en ejecucin o desde
el entorno de desarrollo de Power Builder se requieren ciertos elementos de
informacin como por ejemplo el nombre de la base de datos, el usuario y su
clave, etc que son necesarios en casi todas las conexiones a base de datos, y
otros como el nombre del servidor, son necesarios en algunos sistemas de gestin
de base de datos (SGBD).

Entre los atributos ms necesarios tenemos:

DBMS

Facultad de Ingeniera Ing. Ana Doris M. Barrera Loza

Nombre del distribuidor de la Base de Datos. Ejm: ODBC, ORACLE, Sybase, etc.

AutoCommit
Es el indicador automtico de actualizacin. True, confirma automticamente
despus de cada accin de la Base de Datos; False (por defecto) no confirma
automticamente.

DbParm
Hay que dar especificaciones del SGBD como:
Connectstring donde se le indica el DSN que se esta utilizando.
UID, se le indica el nombre del usuario, por defecto DBA.
PWD, es el password del usuario, por defecto, sql.

Database
Nombre de la base de datos a la que se est conectando.

UserId
Nombre o ID del usuario que conectar a la Base de Datos.

DBPass
Es la palabra clave que se utilizar en la conexin a la Base de Datos.

Logld
Nombre o ID del usuario que conectar al servidor.

LogPassword
Palabra clave utilizada para conectar al servidor.

ServerName
Nombre el servidor en el que reside la Base de Datos.

SQLCode
Cdigo de xito o falla de la operacin ms reciente.

Facultad de Ingeniera Ing. Ana Doris M. Barrera Loza

SQLDBCode
Cdigo de error del distribuidor de la Base de Datos.

Facultad de Ingeniera Ing. Ana Doris M. Barrera Loza