Iniciando POWERBUILDER Versin 5.

Para ingresar al PowerBuilder versin 5.0 desde Windows 95, seguir los siguientes pasos: Dar un click sobre el botn . Arrastrar el mouse y dar un click en . En el siguiente grupo de opciones, seleccionar dando un click sobre la Carpeta , luego dar doble click en

A continuacin, aparecer momentaneamente una pantalla como la que se muestra:

Requisitos de Instalacin

Sistemas Operativos Microsoft Windows 95 Microsoft Windows NT 3.51 Memoria 16 Mb de RAM (Recomendado : 32 Mb de RAM Espacio en disco duro: 160 Mb Instalacin Compacta 190 Mb Instalacin Tpica Ratn de Microsoft o compatible. PC con procesador 486DX/4 superior. (Recomendado Pentium) Tarjeta Grfica VGA o superior (Recomendado SGVA de 256 colores) Unidad de Floppy de 3.5 pulgadas (alta densidad). CD- ROM. Conceptos Generales Qu es PowerBuilder? Es un entorno de programacin que est compuesto por diferentes herramientas, para el desarrollo rpido de una aplicacin en el ambiente cliente - servidor. Permite usar ventanas, botones y todas las herramientas que presenta windows, facilitando su manejo. Se maneja bsicamente con el ratn, y el lenguaje de programacin llamado PowerScript. Esta herramienta de desarrollo est completamente orientada a objetos, lo que permite a equipos de programadores crear aplicaciones grficas sofisticadas con acceso a informacin de base de datos locales o en servidores de red. Caractersticas Bsicas Power Builder es un desarrollador de aplicaciones, cuyas caractersticas bsicas son: o Soporta una gran variedad de sistemas de gestin de base de datos, tales como: Sybase, Informix, Oracle, Watcom, entre otras. o Tiene capacidad de acceder a informacin de mltiples bases de datos y mostrar esa informacin en una nica ventana. o Se trabaja en ambiente cliente - servidor. o Posee un objeto inteligente llamado Datawindow que realiza directamente la interface con la base de datos, sin requerir que el programador conozca SQL. o Capacidad de utilizar sentencias SQL combinadas en el cdigo. o Se puede trabajar en mltiples plataformas, ya que soporta diferentes sistemas operativos y posee drivers nativos para las bases de datos ms comerciales.

o o o o

La creacin de aplicaciones es sencilla. Se realiza poca programacin. Permite usar ventanas, botones y todas las herramientas que presenta el windows facilitando su manejo. Para construir la aplicacion se utilizan painters, all se definen las propiedades de los objetos y se agregan los controles. Se puede trabajar con mltiples ventanas.

PowerBuilder, ofrece a los programadores: o o o o o o o o o o o Un entorno de desarrollo profesional. La Orientacin a Objetos. Rapidez de aprendizaje y de desarrollo. Generacin automtica de cdigo SQL. Acceso a las aplicaciones de Windows. Una herramienta de desarrollo asequible y rentable en explotacin. Un entorno abierto de desarrollo que dispone de interfaces inteligentes a otras tecnologas Cliente/Servidor. Abierto a la mayora de Base de Datos del mercado. Abierto a diferentes herramientas CASE. Abierto a Libreras de objetos y control de versiones. Abierto a aplicaciones Windows: DLL, DDE, OLE.

Eventos y Scripts Un evento se ejecuta por ejemplo cuando se hace Click en un botn o al salir de cualquier control. En el Script se escriben los comandos y funciones que se realizan cuando se ejecuta algn evento. Funciones Permite al programador hacer ms fcil la programacin. PowerBuilder posee una gran cantidad de funciones que se pueden usar en los objetos, por ejemplo se pueden usar para abrir o cerrar una ventana o para activar algn botn. Libreras Las libreras o PBL es el contenedor bsico de objetos PowerBuilder (ventanas, menues, datawindows). Cualquier cosa que se cree deber estar contenida en una PBL o librera. Una aplicacin puede tener una o ms libreras. De una PBL se puede generar una PBD, que es lo mismo que una PBL pero sin el cdigo fuente, o una DLL tpica de windows.

El Ambiente del POWERBUILDER Una vez que se ha iniciado el PowerBuilder, lo primero que se aprecia es una ventana con un men y una barra de herramientas (PowerBar), similar a la que se presenta a continuacin:

En la versin 5.0 del PowerBuilder abre por defecto la aplicacin activa. Si es la primera vez que se carga el PowerBuilder, aparecer por defecto la aplicacin de ejemplo del PowerBuilder. En el ambiente de desarrollo, para crear los objetos se usan painters o pintores. Cada pintor tiene un icono asociado. Para los diferentes iconos, seleccionar la opcin PowerPanel desde el men File.

Power Panel La caja de dilogo mostrada arriba se llama `PowerPanel'. Para invocar un pintor desde el PowerPanel, se necesita seleccionar el pintor haciendo "click" sobre el icono/texto y seleccionar el botn 'OK'. Antes de hacer cualquier otra cosa describiremos cada uno de los painters o pintores. PAINTERS O PINTORES DE OBJETOS :

Son pintores para crear objetos que se almacenan en las librerias Power Builder.

Pintor de Aplicacin El objeto de aplicacin es el punto de entrada a cualquier aplicacin Power Builder. Si se hace una comparacin, sera algo as como `main()' en un programa de `C'.

Pintor de Ventana En cualquier aplicacin, la pantalla es la interface principal entre el usuario y la aplicacin. Una pantalla permite hacer entrada de datos, ver informes,etc. En PowerBuilder, las pantallas se llaman `Windows'. El Pintor de Ventana, como el nombre lo dice, permite pintar y salvar objetos de ventana. Sobre una ventana se puede pintar diversos controles, tales como CommandButtons, ListBoxes, Pictures,etc.

Pintor de Men Un men es simplemente una lista de opciones o comandos. Un ejemplo de men, el men del PowerBuilder. En PowerBuilder se puede crear objetos men en el pintor de men y asignarlos a las pantallas (ventanas). Tambin se pueden pintar menes popup ( menes sensibles de contexto) en el pintor de men.

Pintor de DataWindow El objeto DataWindow permite recobrar datos desde la base de datos u otras fuentes. Mediante un datawindow tambin se puede hacer entrada de datos. Despus de pintar el objeto de DataWindow, no puede usarse el objeto solo. Se necesita asociar el objeto DataWindow con el control DataWindow y poner el DataWindow control sobre la pantalla (ventana).

Pintor de Tubera de Datos El objeto de Tubera de Datos permite copiar tablas y sus datos desde una base de datos a otra, con pocas lneas de cdigo.

Pintor de Objetos de Usuario Es una coleccin de uno o ms objetos de PowerBuilder/ no-PowerBuilder. Los objetos no-PowerBuilder incluyen objetos de VB, DLLS, OCX y otros. El Objeto de Usuario permite reusar el cdigo.

Pintor de Consultas El Pintor de Consultas permite construir declaraciones SQL SELECT que pueden salvarse como objetos de Consulta en la biblioteca de PowerBuilder.

Pintor de Funciones El pintor de funciones permite construir objetos de funcin que pueden usarse para definir una serie de comandos, frecuentemente usados. En PowerBuilder, una funcin es una coleccin de comandos PowerScript o declaraciones de SQL dinmicos. Se puede referir tambin a estas funciones en su PowerScript y tambin en el pintor de Datawindow.

Pintor de Estructura El Pintor de Estructura permite crear objetos de estructura. Una estructura es un conjunto de variables conexas (que puede tener los tipos diferentes de datos) agrupadas bajo un nombre nico. OTROS PINTORES

Pintor de Biblioteca Los objetos que crean en los Pintores de PowerBuilder (aplicaciones, ventanas, menes, funciones, consultas, estructuras, objetos de usuario y DataWindows) se almacenan en un archivo de sistema con extensin ".pbl". En la terminologa de PowerBuilder, este archivo se llama "la Biblioteca". El Pintor de Biblioteca permite crear

y mantener bibliotecas de PowerBuilder y objetos en esas bibliotecas.

Pintor de base de datos El Pintor de base de datos permite crear objetos de base de datos como tablas, vistas, ndices, etc., sin saber la verdadera sintaxis. Todos los objetos de base de datos que se crean en este pintor se almacenan en la base de datos conectada, no en la biblioteca de PowerBuilder. Los objetos que se crean en los otros painters, como ventanas o el men, se almacenan en la biblioteca de PowerBuilder. Se puede hacer tambin administracin de base de datos desde el pintor de base de datos.

Pintor de Proyecto El Pintor de Proyecto, permite crear Bibliotecas Vinculadas Dinmicas (PBDS PowerBuilder), ejecutables.

Corrida El Icono de Corrida permite ejecutar la aplicacin.

Debug El pintor de Debug permite inspeccionar la ejecucin de la aplicacin actual gradualmente, simplificando el descubrimiento de los errores en la aplicacin. Usando los PAINTERS o PINTORES Al usar los painter o pintores se visualizan 4 componentes bsicos: 1. The title bar : Identifica la ventana y muestra el nombre de la aplicacin actual. 2. The menu bar : Muestra las opciones disponibles del men. 3. Workspace : Espacio en el cual se pueden colocar los objetos a utilizar. 4. Toolbars : Provee varias barras de herramientas para hacer el trabajo rpido.

Usando la BARRA DE HERRAMIENTAS PowerBuilder usa 4 barras de herramientas (Toolbars): 1. PowerBar : contiene iconos para abrir pintores y otras herramientas. 2. PainterBar : manipula componentes en el painter activo. 3. StyleBar : cambia atributos de los textos (tipo, tamao y fondo). 4. ColorBar : cambia los colores de los componentes en el pintor actual. El programador puede controlar qu barra de herramientas puede usar y dnde visualizarlas. Adems se puede agregar, mover y deletear iconos en el Power Bar y en el PainterBar.

Mostrando la Barra de Herramientas Si se muestra la barra de herramientas (toolbars), se puede escoger dnde mostrarlo y decidir si se muestra o no texto sobre los iconos. Si se elige mostrar texto, ste afecta a toda la barra de herramientas, o de lo contrario el texto es omitido. Usando el Mouse para mover las Barras de Herramientas Para mover la barra de herramientas (toolbars) con el mouse, se tiene que hacer lo siguiente: - Ubicar el cursor sobre un espacio vaco dentro del toolbar - Pulsar y retener el botn izquierdo del ratn. - Arrastrar la barra de herramientas y dejarla donde se desee.

Personalizando la Barra de Herramientas Se puede personalizar la barra de herramientas (toolbars) con los iconos del PowerBuilder y con los iconos invocar otrar aplicaciones Windows, tal como la Calculadora o Notepad.

Adicionar, Mover y Borrar Iconos Se puede agregar, mover y borrar iconos en el PowerBuilder y en el PainterBar. No se puede accesar iconos en el StyleBar o ColorBar. Usando el

PowerBar

El Power Bar se muestra cuando se inicia una sesin de Power Builder. El PowerBar es el control principal para construir aplicaciones PowerBuilder. Desde el PowerBar se puede abrir el Painter de PowerBuilder, depurar o correr la aplicacin actual, pedir ayuda o personalizar PowerBuider para cualquier necesidad. Se puede personalizar PowerBuilder. Por ejemplo, se puede agregar iconos para operaciones que se necesiten con mayor frecuencia. Usando Iconos

Los iconos en el Power Bar ( y en el Power Panel) representan cada una de las herramientas y pintores frecuentemente usados en PowerBuilder.

Usando el Men POPUP Power Builder provee un contexto sensible de men popup que lista los items apropiados para el objeto seleccionado. El men popup est disponible en cualquier lugar del PowerBuilder. Para usar el Men PopUp: * Seleccionar uno o ms objetos * Dar click con el botn derecho del mouse, el men apropiado se displayar. * Seleccionar el item deseado. Trabajando con Ventanas en Power Builder Cada Painter de PowerBuilder muestra su propia ventana. Se puede abrir varios painters a la vez y tambin varias instancias de un painter. Ejemplo : Si ha abierto varias ventanas en PowerBuilder, puede moverse de una a otra, pulsando los botones: Crtl + Tab. Usando la Ayuda en Linea PowerBuilder tiene una extensa ayuda en lnea. Cuando se requiere usar el help,

seleccionar el icono Help (

) o F1,la ayuda est disponible en cualquier lugar.

La ayuda sensitiva al contexto slo es disponible en las funciones y en el script. Ejemplo : Si se est escribiendo en el script la palabra password y se desea saber en qu objetos puede ser usada, seleccionar la palabra y presionar Shift + F1 y a continuacin, aparecer una ventana similar a la siguiente:

Esta ayuda complementa la informacin que aparece en los manuales del PowerBuilder y, adems, provee de una orientacin, referencia y ejemplos de aplicacin.

Construyendo una APLICACION

El punto de inicio de cualquier proyecto que se ha de realizar en PowerBuilder es crear la aplicacin, ya que en la aplicacin es donde se disea el ambiente donde se va a trabajar ( equivalente a crear un proyecto en Visual FoxPro). Una aplicacin tiene como elementos a las ventanas, los menes, los datawindows, los objetos de usuario, entre otros. Crear una aplicacin en PowerBuilder consiste en crear cada una de sus piezas con el painter adecuado, y despus codificar las interacciones entre ellas. El orden lgico de esta creacin podra ser:

Las convenciones para los nombres de los objetos son recomendados para una fcil identificacin de los objetos y controles a los que se hace referencia.

Ejemplo. windows w_principal datawindow dw_principal

menu command button

m_principal cb_ Ok

Como se puede apreciar en el grfico anterior, las opciones de men que se nos ofrecen desde el painter aplicacin incluye:
* Crear una aplicacin nueva, * Abrir una ya existente, * Grabar, * Introducir cdigo en los scripts, * Modificar las propiedades y * Salir.

Si creamos una aplicacin nueva se nos preguntar primero si deseamos crear la Pbl contenedora o utilizar una ya creada anteriormente. En este painter es donde creamos el objeto aplicacin, que es lo primero que deberamos crear al empezar un nuevo proyecto. Este objeto contendr el cdigo que debe ejecutarse al arrancar y parar la aplicacin. El apartado ms importante para el que empieza a programar es el de las libreras, el cual contendr las rutas de las Pbl (libreras) que nuestra aplicacin va a utilizar. Una aplicacin recin creada slo contendr una librera, la que se ha utilizado para crear el objeto aplicacin, las dems (si hubiesen) se han de introducir manualmente.
Eventos del Objeto APLICACION

PowerBuilder es un lenguaje orientado a eventos. Esto significa que los objetos con los que tratamos tienen predefinidas unas "rutinas" vacas que sern llamadas por el sistema de forma automtica, cada vez que ocurra una accin concreta. Cada evento tiene asociado una accin o suceso del sistema.

Tambin podemos crear nuestros propios eventos (User Event) . Si elegimos el botn de barra de herramientas, se nos abrir una ventana parecida a la siguiente:

Fijmonos en la lista desplegable (tambin llamada cuadro combinado o combo box. En PowerBuilder se le conoce como Drop Down List) de la esquina superior izquierda. Si pulsamos en la flecha se nos abren todos los eventos disponibles para este objeto. Los ms importantes son:

Si por ejemplo deseamos realizar alguna accin inmediatamente despus de que la aplicacin se ponga en marcha, slo tenemos que escoger el evento open y escribir en el lenguaje PowerScript las instrucciones que se deseen.
Creando la primera APLICACION

Vamos a crear nuestra primera aplicacin, la llamaremos "Publicaciones" y los pasos a seguir seran los siguientes: 1. Ejecutar PowerBuilder 2. Dar un click en Application Painter (pintor de aplicacin). 3. Seleccionar File / New o el icono . 4. PowerBuilder preguntar qu Pbl (librera) deseamos escoger para grabar la nueva aplicacin, si digitamos un nombre que no existe, crearemos una nueva Pbl.

5.

El siguiente paso es darle un nombre al objeto aplicacin, Tambin se pue- de aadir un comentario. (Ver Fig. 1) 6. PowerBuilder nos pregunta si deseamos generar un "Application template", esto provocar que nos genere una aplicacin que cree un entorno mdi listo para funcionar, contestaremos que no. (Ver Fig. 2)

7. 8.

Escoger la opcion Close del menFile. Pulsar el botn y veremos una vista de la pbl que acabamos de crear con el objeto aplicacin dentro.

9.

Ahora vamos a introducir cdigo en el evento open. Abrimos el pintor de Aplicacin. 10. Escogemos el botn de la barra de herramientas que corresponde al script ( ). 11. Seleccionamos en la lista de la izquierda el evento open.

12.

Tecleamos la instruccin:

MessageBox ("Aviso", "Esta aplicacion, ms adelante ser un control de publicaciones!!!").

13.

Compilar la sentencia escrita con el icono ( ) de la barra de herramientas del pintor aplicacin. 14. Cerramos la ventana del script dando un click en el ltimo botn de la barra de herramientas del pintor aplicacin ( ). 15. 16. Para grabar, pulsar sobre el botn del diskette ( ). Por ltimo, hacer click en el botn de Run ( ).

Listo, ya hemos realizado nuestro primer programa en PowerBuilder..... !

Observacin importante: Aunque PowerBuilder est pensado para crear aplicaciones tipo MDI, este programa demuestra que no es imprescindible abrir ninguna ventana para que el programa haga algo. Con PowerBuilder tambin se puede realizar procesos no interactivos que hagan su trabajo en background. En los prximos captulos, a medida que se incrementen los conocimientos, se podr crear un programa que se conecte a la base de datos y abra una ventana marco MDI principal y una ventana tipo "sheet".

Construyendo una APLICACION El punto de inicio de cualquier proyecto que se ha de realizar en PowerBuilder es crear la aplicacin, ya que en la aplicacin es donde se disea el ambiente donde se va a trabajar ( equivalente a crear un proyecto en Visual FoxPro). Una aplicacin tiene como elementos a las ventanas, los menes, los datawindows, los objetos de usuario, entre otros. Crear una aplicacin en PowerBuilder consiste en crear cada una de sus piezas con el painter adecuado, y despus codificar las interacciones entre ellas. El orden lgico de

esta creacin podra ser:

Las convenciones para los nombres de los objetos son recomendados para una fcil identificacin de los objetos y controles a los que se hace referencia. Ejemplo. windows w_principal datawindow dw_principal menu m_principal command button cb_ Ok

Como se puede apreciar en el grfico anterior, las opciones de men que se nos

ofrecen desde el painter aplicacin incluye: * Crear una aplicacin nueva, * Abrir una ya existente, * Grabar, * Introducir cdigo en los scripts, * Modificar las propiedades y * Salir. Si creamos una aplicacin nueva se nos preguntar primero si deseamos crear la Pbl contenedora o utilizar una ya creada anteriormente. En este painter es donde creamos el objeto aplicacin, que es lo primero que deberamos crear al empezar un nuevo proyecto. Este objeto contendr el cdigo que debe ejecutarse al arrancar y parar la aplicacin. El apartado ms importante para el que empieza a programar es el de las libreras, el cual contendr las rutas de las Pbl (libreras) que nuestra aplicacin va a utilizar. Una aplicacin recin creada slo contendr una librera, la que se ha utilizado para crear el objeto aplicacin, las dems (si hubiesen) se han de introducir manualmente. Eventos del Objeto APLICACION PowerBuilder es un lenguaje orientado a eventos. Esto significa que los objetos con los que tratamos tienen predefinidas unas "rutinas" vacas que sern llamadas por el sistema de forma automtica, cada vez que ocurra una accin concreta. Cada evento tiene asociado una accin o suceso del sistema.

Tambin podemos crear nuestros propios eventos (User Event) . Si elegimos el botn de barra de herramientas, se nos abrir una ventana parecida a la siguiente:

Fijmonos en la lista desplegable (tambin llamada cuadro combinado o combo box. En PowerBuilder se le conoce como Drop Down List) de la esquina superior izquierda. Si pulsamos en la flecha se nos abren todos los eventos disponibles para este objeto. Los ms importantes son:

Si por ejemplo deseamos realizar alguna accin inmediatamente despus de que la aplicacin se ponga en marcha, slo tenemos que escoger el evento open y escribir en el lenguaje PowerScript las instrucciones que se deseen. Creando la primera APLICACION Vamos a crear nuestra primera aplicacin, la llamaremos "Publicaciones" y los pasos a seguir seran los siguientes: 1. Ejecutar PowerBuilder

2. 3.

Dar un click en Application Painter (pintor de aplicacin). Seleccionar File / New o el icono . 4. PowerBuilder preguntar qu Pbl (librera) deseamos escoger para grabar la nueva aplicacin, si digitamos un nombre que no existe, crearemos una nueva Pbl.

5.

El siguiente paso es darle un nombre al objeto aplicacin, Tambin se pue- de aadir un comentario. (Ver Fig. 1) 6. PowerBuilder nos pregunta si deseamos generar un "Application

template", esto provocar que nos genere una aplicacin que cree un entorno mdi listo para funcionar, contestaremos que no. (Ver Fig. 2)

7.
8.

Escoger la opcion Close del menFile. Pulsar el botn y veremos una vista de la pbl que acabamos de crear con el objeto aplicacin dentro.

9.

Ahora vamos a introducir cdigo en el evento open. Abrimos el pintor de Aplicacin. 10. Escogemos el botn de la barra de herramientas que corresponde al script ( 11. ). Seleccionamos en la lista de la izquierda el evento open.

12.

Tecleamos la instruccin: MessageBox ("Aviso", "Esta aplicacion, ms adelante ser un control de publicaciones!!!").

13.

Compilar la sentencia escrita con el icono ( ) de la barra de herramientas del pintor aplicacin. 14. Cerramos la ventana del script dando un click en el ltimo botn de la barra de herramientas del pintor aplicacin ( ). 15. 16. Para grabar, pulsar sobre el botn del diskette ( Por ltimo, hacer click en el botn de Run ( ). ).

Listo, ya hemos realizado nuestro primer programa en PowerBuilder..... !

Observacin importante: Aunque PowerBuilder est pensado para crear aplicaciones tipo MDI, este programa demuestra que no es imprescindible abrir ninguna ventana para que el programa haga algo. Con PowerBuilder tambin se puede realizar procesos no interactivos que hagan su trabajo en background. En los prximos captulos, a medida que se incrementen los conocimientos, se podr crear un programa que se conecte a la base de datos y abra una ventana marco MDI principal y una ventana tipo "sheet".

Construyendo Ventanas (Windows) Las aplicaciones PowerBuilder consisten en ventanas (windows) que interactan con el usuario. EL OBJETO WINDOWS ( Ventana ) Las ventanas son la interface entre el usuario y una aplicacin Power Builder. Muestran informacin requerida e interactan con el usuario. Un Ventana consta de: o Atributos: Son los que definen el comportamiento y apariencia de la ventana. Estos pueden ser cambiados . Ejm (color, ttulo, etc).

o o

Eventos: Especifican lo que sucede cuando un window es manipulado. Ejem: evento close (ocurre al cerrar una ventana) Controles: Colocados sobre un windows, para recibir y brindar informacin al usuario. Ejm (command button, singleline edit, radio button, etc).

Entorno Windows (Ventana) Un window (ventana) es un trmino para una pantalla. Se puede tener mltiples ventanas en la pantalla al mismo tiempo y cada ventana trabaja independientemente. En PowerBuilder se crean ventanas usando el Pintor de Windows. Se puede abrir el pintor de windows haciendo click con el mouse sobre el botn ( presionando Shift + F2. ) situado en el PowerBar, o

La barra de herramientas de este painter (pintor) es mucho ms compleja que la del objeto aplicacin.

Los botones que tienen una flecha negra a la derecha despliegan una lista con ms botones al pinchar sobre ella.

Uno de los botones ms importantes es el cuarto empezando por la izquierda. Al pulsar sobre la flecha negra que despliega la lista, muestra todos los objetos que podemos pegar encima de la ventana (controles que describiremos ms adelante). Estos controles se pueden pegar en la ventana y al pulsar el boton derecho del mouse sobre ellos, aparece un men, qu entre otras opciones muestra la opcin properties (propiedades) y la opcin de script (cdigo). Estas dos son las ms utilizadas, nos permiten cambiar algunas propiedades y codificar los eventos con las instrucciones de PowerScript que describiremos ms adelante.

Construyendo una Ventana A continuacin se describir cmo construir una ventana que no est basada en una ya existente. Al acceder al pintor de window ( librera actual. ) , se displaya el select window y lista los window de la

Las ventanas (windows) pueden ser heredadas (Inherit).

Para construir una nueva ventana, seguir los siguientes pasos: o o Hacer click en botn New o dar click en el botn de la barra de herramientas del pintor window. A continuacin, se displayar el workspace (espacio de trabajo ) y es aqu donde se definir la apariencia y comportamiento del window (ventana).

Tipos de Ventanas (Windows) Hay varios tipos de ventanas Windows Main : Son ventanas que son independientes de otros windows. La primera ventana (window) abierta en la aplicacin es el window Main, a menos que sea una aplicacin MDI. Window Popup : Un popup tiene una ventana de origen como la ventana pequea pero no tiene todas las limitaciones. Window Child : Los windows Child son siempre abiertos desde un window main o popup, los que llegan a ser su window parent. Un window Child slo existe dentro de su parent. No puede tener asociado un men y nunca son considerados como el window activo. Un window child se cierra cuando su parent se cierra. Window Response : Los window response piden informacin al usuario, siempre son abiertos dentro de otro window ( su pariente ). MDI Frame : Un MDI window es un frame window, y es usado cuando el usuario necesita organizar los trabajos con mltiples ventanas

Ejemplo : Ventana de impresin ( tpico ejemplo de una ventana Response ) Propiedades del Window (Ventana) Cada ventana y cada uno de sus controles tiene un estilo que determina la apariencia para el usuario.

Cuando define un estilo para una ventana (window) se le asigna valores a las propiedades de dicha ventana. Para el ejemplo: la ventana ser visible, de tipo main, de color silver, entre otros.

Para definir el estilo de windows, realizar los siguientes pasos: o o o o o o Hacer doble click sobre el window (aparecer una pantalla similar a la superior). Especifique el tipo de window (Window Type). Especifique otras propiedades del window. Asociar un men con el window (si lo desea). Escoger el color para el background del window (Window Color). Finalmente, hacer click en OK.

ESPECIFICANDO EL TIPO DE WINDOW Lo primero que se debe hacer despus de crear un window es especificar su tipo, para ello: o Escoger el tipo de ventana en la lista desplegableWindow Type, en la ventana de propiedades de la ventana. o Definiendo el tipo de window se habilitarn o deshabilitarn ciertas propiedades del windowEjemplo: Si se crea un window de tipo Main el Title Bar Check box y el border check box ( ) aparecern deshabilitados. ESPECIFICANDO OTRAS PROPIEDADES BASICAS Tambin puede especificar si el window se maximiza, tiene Scrollbars, visible, enabled, resizable, entre otros. ( )

Notitas:

o o o

Un window main debe tener un ttulo. Un window child no puede tener men. Un window response no puede tener men, maximize box, minimize box, ni resizable (es decir, su tamao no puede variar).

ASOCIANDO UN MENU A LA VENTANA

Para asociar un men a un window, digitar el nombre del men a asociar en el campoMenu Name de la ventana de propiedades. En el caso que el men que se desea seleccionar no aparezca en la lista (P.B. lista todo los menes de la aplicacin), hacer click en el botn y escoja el men deseado. Se puede cambiar un men asociado con un window durante ejecucin con la funcinChangeMenu.

ESCOGIENDO EL COLOR DE LA VENTANA

Para cambiar el color de la ventana, seguir los siguientes pasos: o Seleccionar un color en el Listbox Window colorde la ventana de propiedades de la ventana.

CAMBIANDO EL TAMAO Y LA POSICION En la ventana de propiedades de la ventana (ingresar haciendo doble click sobre la ventana), escoger la carilla y seguir los siguientes pasos :

o o o

Seleccionar el estado inicial del window (Normal, Minimizado o Maximizado). Mover el window a un lugar apropiado con el mouse o dando valores a X e Y. Hacer click en OK Para window Main, Popup, Response y MDI frame, X e Y son relativos a la esquina superior izquierda del y para window child, X e Y son relativos al parent).

Para cambiar el tamao del window (ventana): o Usar el mouse para modificar el tamao o cambiar los atributos Width y Height. GRABANDO EL WINDOW El window (ventana) creado se guarda en una de las librera PBL. Para ello, selecionar SAVE del File Menu, o hacer click en el icono ( ) de la barra de herramientas del pintor window , a continuacin aparecer una pantalla digitar el nombre del window.

VISTA PREVIA DEL WINDOW Mientras construye el window, se pueden ir haciendo vistas previas. Para ello hacer click en ( ) de la barra de herramientas del pintor de Window. Eventos de una Ventana Al igual que se ha visto en el Painter Application y tal como se ver en el resto de objetos de PowerBuilder, al pulsar el botn derecho sobre la ventana y escoger la opcin script, se abre la ventana de edicin de cdigo. Los eventos ms utilizados a la hora de codificar en una ventana son:

Evento

Descripcin

Activate: Ocurre inmediatamente despus de abrirse la ventana. La ventana activa se muestra con un ttulo sumamente iluminado. Clicked: Ocurre cuando se hace un click en una ventana, pero no dentro de los controles (as como un command Bottom). Close:Ocurre antes de que la ventana est desactivada y cerrada. Close Query: Los query de una ventana le dan una oportunidad de manejar

cualquier ltimo detalle, as como guardar cualquier cambio actual a un archivo o una tabla. El evento ocurre antes del cierre de eventos y es posible que reuse a permitir que la ventana se cierre. Desactivate: Este evento es impulsado antes de que la ventana llegue a estar inactiva. Double Clicked: Ocurre cuando se hace doble click en una ventana, pero no dentro de los controles. DragDrop: Ocurre cuando el modo drag y el puntero drop estn en un objeto de la ventana (no dentro de un control) DragEnter: Ocurre cuando el modo drag est en un objeto de entrada de la ventana. DragLeave: Ocurre cuando el modo drag est en los objetos que van a salir de la ventana. DragWithin: Cuando el modo drag est en los eventos que son impulsados peridicamente mientras que un objeto est dentro de la ventana. Hide: Esta ventana se hace invisible. HotLinkAlarm: Ocurre despus que una conexin DDE ha sido efectuada. Key: Ocurre cuando el teclado es presionado y el foco no est dentro de un control de edicin. MouseDown: Ocurre cuando se da click al botn izquierdo del mouse. MouseMove: Ocurre cuando el mouse se ha movido dentro de la ventana. Mouse Up: Ocurre cuando el botn del mouse es soltado dentro de la ventana y el sealador no est localizado dentro de cualquier control activado. Open: Este evento ocurre al abrirse, antes de que el usuario vea nada. Other: Todo los eventos de la otra ventana que han sido sealados por los eventos del PB, estn ruteados en este evento, raramente se usar este evento. Rbutton Down: Ocurre cuando se presiona el botn derecho del mouse. Resize: Ocurre al cambiar el tamao de la ventana. Show: Este evento es impulsado antes de llamar a la funcin show. SystemKey: Evento impulsado antes que el usuario presione la tecla Alt (usualmente en combinacin con otra tecla) y el foco no estar dentro de un tipo de edicin activa del control. Timer: Ocurre con intervalos especficos como colocar la funcin de tiempo.

El evento del tiempo es solamente impulsado si la funcin del timer fue llamada. Funciones de una Ventana

Las funciones que se mencionan a continuacin se aplican especficamente a los objetos de las ventanas: ArrangSheets: Organiza a las hojas de las ventanas en un estilo especfico, como tiled o cascada. Change Menu: Asigna el men asociado con una ventana a unanamed men ClasName: Retorna el nombre de la ventana. GetActiveSheet: Retorna cual es la ventana que est actualemente activa en la ventana de hoja. Hide: Hace que la ventana se haga invisible. Move: Cambia la ventana a una nueva posicin. ParentWindow: Retorna cual es la ventana padre. Pointer X: Devuelve la actual posicin horizontal del puntero. Pointer Y: Devuelve la actual posicin vertical del puntero. Postevent: Adiciona un evento a la cola de mensaje de un objeto (un mensaje asincrnico). Resize: Cambia el actual tamao de la ventana. SetFocus: Activa el foco de la ventana, haciendo que sta sea la actual ventana activa. Setmicrohelp: Asigna un texto en lnea de status del MDI y lo displaya. SetPosition: Mueve la ventana al frente o posterior a otra ventana. SetRedraw: Enciende o apaga el estado de actualizacin para una ventana. Show : Displaya una ventana. TriggerEvent: Enva un mensaje para un evento del objeto. TypeOff: Retorna el tipo de objeto

Introduccin a los Controles Cuando se ejecuta la aplicacin los usuarios interactan generalmente con los controles colocados en la ventana (window). Hay dos tipos de controles : - Controles que tienen eventos - Controles sin eventos (Group Boxes y los drawing objects (objetos para dibujar)). Hay controles para: Mostrar y / o manipular valores: Static text SingleLineEdit MultilineEdit EditMask CommandButton Data Window (control especial para la presentacin de datos) PictureButton User Object TreeView, ListView, Tabs. Hacer cambios: Incluyen los siguientes controles

CheckBox

List Box

DropDownListBox RadioButton Mostrar Informacin Grfica : Incluyen los siguientes controles

 Graph

HScrollBar VScrollBar

Para Dibujar sobre la Ventana GroupBox Line

Oval

Rectangle

RoundRectangle

Picture

Colocando Controles en una Ventana

Para colocar un control en la ventana (window), seguir los siguientes pasos: o o Seleccionar el control del window PainterBar o del MenuControl. Hacer click donde se quiere colocar el control.

Despus de colocar el control puede cambiar de tamao, definir su apariencia y comportamiento, y asociar scripts para los eventos. CAMBIANDO LAS PROPIEDADES DEL CONTROL Cada control tiene propiedades que determinan su apariencia y comportamiento. Para definir las propiedades, seguir los siguientes pasos: Hacer click con el botn derecho del mouse sobre el control. A continuacin aparecer un men emergente con varias opciones. (ver a la derecha) Seleccionar la opcin propiedades (properties) del control. Si se prefiere, hacer doble click sobre el control y aparecer la ventana de propiedades del control.

o o o o

Cuando coloque un control en una ventana (window), PowerBuilder asigna un nombre nico al control de la siguiente manera: prefijo de control_ + nmero el nmero puede ser cambiado por una palabra representativa para el control. Para el ejemplo el prefijo del control comand button ser: cb_grabar1

A continuacin, se muestra una lista con los principales controles y sus prefijos:

ENTORNO BASES DE DATOS

Antes de comenzar a trabajar en una aplicacin PowerBuilder se debe crear la base de datos, el enlaceODBC y un database profile. Pero ....... Qu es un database profile?. Es el enlace que utilizarn los pintores (painters) del entorno PowerBuilder a la base de datos. La aplicacin debe conectarse explcitamente, mediante un script (cdigo) a la base de datos. Pero cuando la aplicacin no est ejecutndose, qu base de datos han de usar los pintores? Esto se especifica pulsando el botn del PowerBar.

Para nuestro ejemplo usaremos la base de datos Publi. Se pueden definir varios profiles, pero slo uno ser el activo. Se puede conectar a una base de datos cuando se ejecuta la aplicacin y a otra mientras se est diseando, as que hemos de tener cuidado de no equivocarnos. El enlace ODBC podemos crearlo a travs del panel de control de windows o dentro del mismo PowerBuilder con el botn del PowerBar (ver Pag 53). Si se crea el ODBC dentro de PowerBuilder, ste crear el profile por s solo, de manera que slo tenemos que pulsar el botn database profile, y escogerlo para que sea el activo. A partir de entonces, todas las operaciones que ejecutemos sobre datawindows o base de datos, repercutirn sobre la base de datos activa.

Ejemplo: Base de datos de Publicaciones

CREANDO LA BASE DE DATOS Para crear la base de datos, como se muestra en el ejemplo, seguir los siguientes pasos: o Pulsar el botn (pintor de base de datos). A continuacin se mostrar una lista de las tablas de las bases de datos. Tambin se puede crear y modificar las tablas desde aqu. Si se desea crear una base de datos nueva, hacer click en el botn cancelar e ir al men File y seleccionar la opcion Create Database.

:
A continuacin aparecer una ventana similar a la de la derecha, en la que se escribir el nombre que se desea dar a la base de datos y hacer click en el botn Ok.

EL ENTORNO MENU Con el pintor men se disearn los menes que aparecern en las diferentes ventanas de una aplicacin. Las aplicaciones pueden ser de dos tipos: SDI = Single Document Interface. La aplicacin consta de una ventana y de un men asociado a la misma. Ejemplo : Block de notas, WordPad. MDI = Multi Document Interface. La aplicacin consta de una ventana principal o marco MDI y de varias secundarias que estn contenidas dentro y que no pueden salir de los lmites visuales de la ventana marco. Ejem: PowerBuilder, Microsoft Word, etc. Al entrar al entorno Men se activa la barra de herramientas de este entorno (toolbars) la cual consta de los siguientes botones:

Pero.... Porqu se usan menes en las ventanas?

CONSTRUYENDO UN MENU Hay dos maneras de construir un men o o Construir un men desde el principio Construir un men que hereda su estilo, funciones, estructuras, variables y script de un men ya existente.

CONSTRUYENDO UN NUEVO MENU Para construir un nuevo men seguir los siguientes pasos: 1. Hacer un click en el icono del pintor de men ( = Men Painter ) en el PowerBar.

A continuacin la ventana de seleccin de Mens lista los Menes en la librera actual si, aplicacin ya tiene menes. Si recin se est creando aparecer una ventana vaca. 2. Haga click sobre el botn Nuevo para construir un nuevo men. Se mostrar luego el espacio de trabajo del Men Painter.

ACERCA DEL PINTOR MENU Tiene varias reas de trabajo : o o o Un rea para especificar los elementos del men de barra. Un rea para definir los elementos de los menes colgantes. Un rea para especificar si es que los elementos se muestran en la barra de herramientas en aplicaciones MDI.

TRABAJANDO EN EL PINTOR MENU En el men painter, se especifica lo siguiente: o o o o Los elementos que se muestran en el men de barra(la barra en la parte superior de la ventana ) Los elementos que se mostrarn debajo de cada opcin del men de barra Atributos de los elementos. Aceleradores y atajos(combinaciones de teclas).

Scripts para los eventos de los elementos del men.

AGREGANDO ELEMENTOS EN EL MENU Cada men consiste de al menos un elemento en el men de barra y elementos en el men colgante. Se puede agregar elementos a un men en tres lugares: En el men barra En el men colgante En el men de cascada Para agregar elementos en el men de barra, seguir los siguientes pasos: 1. 2. 3. 4. 5. Hacer click en el espacio en blanco a la derecha del ltimo elemento definido en el men de barra al tope del espacio de trabajo del Men Painter. PowerBuilder mostrar un campo vaco. Digitar el texto que se mostrar para el elemento. Para agregar otro elemento al men de barra, hacer un click a la derecha del elemento que acaba de definir, PowerBuilder mostrar otro campo vaco. Digitar el texto para el nuevo elemento. Repita los pasos 3 y 4 para agregar elementos adicionales al men de barra.

Para agregar elementos al men colgante, seguir los siguientes pasos: Hacer un click sobre el elemento al cual se le definir un men colgante en el men de barra. PowerBuilder mostrar el men colgante ya definido(si existiera) para el elemento seleccionado. 7. Presionar la tecla TAB o vaya al primer campo vaco debajo del encabezado "Menu for". 8. Digitar el texto que se mostrar para el elemento. 9. Repita los pasos 2 y 3 para agregar elementos adicionales al men colgante. 6.

Para agregar elementos al men en cascada 10. Hacer click sobre el elemento de un men colgante al cual se le quiere asignar un men en cascada.

11.

Hacer click en el icono de siguiente nivel de la barra de herramientas ( ) o seleccione en el men Edit la opcin Next (Siguiente Nivel).

Un campo vaco aparece debajo del encabezado "Menu For"y el puntero se mueve al campo de manera tal que se puede empezar a construir el men en cascada.

Nota: El encabezado "Menu For" muestra el nombre del elemento del men de barra, un triangulo hacia la derecha, el nombre de la opcin que se escogi y otro triangulo hacia la derecha. Esto es para recordar que est ingresando elemento a un men en cascada. Ingrese elementos en un men en cascada de la misma manera que lo hace en menes colgantes. 13. Para ingresar al nivel previo del men, haga click sobre el icono de nivel previo o seleccione Nivel previo de la opcin Edit. 12.

COMO SE NOMBRAN LOS MENUES Cuando se agregan elementos del men, PowerBuilder le da un nombre por defecto, el cual es mostrado en el campo Menu Item Name.

NOMBRE POR DEFECTO DEL MENU El nombre por defecto es una concatenacin del texto especificado para la variable prefijo en la opcin Options del Men Design (inicialmente el prefijo por defecto es m_ y los smbolos y caracteres vlidos para PowerBuilder en el texto que digit para el elemento del men.

Si no hay smbolos o caracteres vlidos en el texto digitado por defecto se coloca el prefijo n, donde n representa el nmero ms bajo que puede ser combinado con el prefijo para crear un nombre nico. INSERTAR ELEMENTOS EN EL MENU Seleccionar el elemento del men de barra que se quiere que est despus, del elemento a insertar. 15. Hacer click en el icono Insertar del PainterBar, o presione la teclaIns o tambin seleccionar Insertar del men Editar. Un campo vaco se mostrar. 16. Tipear el texto del nuevo elemento. 14.

MOVIENDO ELEMENTOS DEL MENU

CREANDO DATAWINDOWS Un datawindow es un objeto visual de acceso a los datos. Bsicamente, este pintor genera una representacin visual de una sentencia Sql del tipo select.

EL OBJETO DATAWINDOWS El Objeto DataWindow es un objeto que se usa para recuperar, presentar y manipular datos de una base de datos relacional u otra fuente de datos (como archivos DBF). Puede, adems, escoger distintos estilos de presentacin (freefrom, Graph,). Los objetos DataWindow tienen conocimiento de los datos que son recuperados. Puede especificar formato de display y otros atributos, de forma tal que los datos son mostrados de manera ms significativa.

Para tener un datawindow en una ventana se debe tener dos elementos:

o o o

Datawindows Objeto ( ver fig. anterior ) Datawindows Control ( Un datawindow control debe asociarse a un datawindow objeto para poder visualizar su contenido en una ventana). Cdigo de conexin de base de datos en el script de la aplicacin y de actualizacin en la ventana en la que se mostrar el datawindow.

CREANDO UN OBJETO DATAWINDOW Para crear un objeto datawindow, seguir los siguientes pasos: o o o o Hacer un click en el pintor DataWindow ( ). A continuacin, el window Select Datawindow se displayar. Hacer click en el botn New. La ventana New DataWindow se displayar.

o o o o o

Escoger el estilo de presentacin: Freeform, tabular, grid, entre otros. (Para el ejemplo se escoger el tipo GRID) [Opcional ] escoger opciones para el Objeto DataWindow. Escoger un Data Source para el Objeto DataWindow. (Para el ejemplo se escoger la fuente de datos Quick Select) Hacer click en el botn Ok. Seleccionar la(s) tabla(s) y campos de la(s) misma(s) que se presentarn en el datawindow.

o o o

Si se desea se puede hacer un previo inmediatamente despus que el Objeto Data Window ha sido definido. Para ello hacer click en el botn () de la barra de herramientas del pintor datawindows. [Opcional ] se puede mejorar la apariencia del ttulo y otros. Guardar el Objeto DataWindow ( hacer click en el botn de la barra de herramientas ). A continuacin aparecer la siguiente ventana:

Es conveniente que el datawindow objeto tenga el mismo nombre que el datawindow control. o Escribir el nombre con el que se va a guardar el objeto datawindow, seguido de la convencin dw_, seleccionar la librera en la que se va a grabar y hacer click en el botn ok.

MODIFICANDO UN DATAWINDOW EXISTENTE o o o o Hacer click al Pintor DataWIndow (datawindow painter). Seleccionar el objeto datawindow de la actual librera. Hacer click en OK. En la ventana que aparecer a continuacin modificar el datawindow seleccionado.

ESCOGIENDO EL ESTILO DE PRESENTACION El estilo de presentacin que se selecciona para un objeto datawindow determina el formato que PowerBuilder usa para el primer display del Objeto DataWindow en el DataWindow painter Workspace. Se pueden escoger los siguientes estilos de presentacin en un nuevo Objeto DataWindow : o o o o o o o o Tabular Freeform Grid Label N-up Group Graph Crosstab

ESTILO TABULAR Este estilo de presentacin presenta los datos a travs de columnas, encabezados(header) y pginas, generalmente muestran muchas filas de las B.D., al mismo tiempo como pueda el Objeto Datawindow. Puede modificar la organizacin default, moviendo las columnas y textos. Este estilo es frecuentemente usado cuando se quiere agrupar los datos.

ESTILO FREEFORM Este estilo de presentacin presenta los datos como columnas de datos, de arriba hacia abajo de la pgina, con su respectiva etiqueta para cada columna. Puede organizar la definicin default moviendo las columnas y textos. Este estilo es frecuentemente usado para entrada de datos(mantenimiento).

ESTILO GRID Este estilo de presentacin, presenta los datos en formato fila-columna con lineas grid que separan filas y columnas. No puede mover las columnas y encabezados como en los estilos anteriores.

ESTI LO LABEL Este estilo presenta los datos como etiquetas. Escoja este estilo para crear etiquetas

de correo u otro tipo de etiquetas.

ESTILO N-UP Este estilo presenta 2 ms filas en la misma lnea del Objeto DataWindow, una seguida de otra. Es similar al estilo label.

ESTILO GROUP Este estilo es una forma corta para crear grupos en un Objeto DataWindow, generando un estilo tabular que est agrupado por ciertas popiedades que son definidas por el que programa.

ESTILO GRAPH Y CROSSTAB Los anteriores estilos son basados en texto. PowerBuilder provee dos estilos que permiten mostrar informacin grficamente : graphs y crosstab.

DEFINIENDO LA FUENTE DE DATOS Al definir la fuente de datos (dataSource), se especifica cul es la fuente de datos que ser usada en el Objeto Datawindow. Se puede escoger de las siguientes fuentes de datos: o Select o Select o Query External Stored Procedure SQL Quick

Si los datos que el Objeto DataWindow muestra, proviene de una base de datos, escoger Quick Select, SQLSelect, Query , o Stored Procedure como la Data Source.

Si los datos a recuperar son de una sola tabla y slo necesita escoger columnas, criterio de seleccin y Sort (No necesita agrupar, campos calculados, etc.), escoger Quick Select SQLSelect. Si la data ha sido definida y salvada en un query, escoger Query. Si la data es definida en un Stored Procedure (procedimieno almacenado), escoger Stored Procedure. Si los datos no provienen de una B.D. , escoger Select externa. Esto incluye las siguientes situaciones: Si los datos sern importados de un archivo externo, tal como un archivo de texto separado por un tab o archivo Xbase(DBF). Si los datos sern importados de una aplicacin DDE.

QUICK SELECT Si slo necesita seleccionar columnas de una sola tabla, use Quick Select data source, el Quick Select genera una sentencia SQL.

SQL SELECT Cuando el SQL Select como Data Source, se construye la sentencia SQL select (grafico o texto) que puede incluir lo siguiente: Ms de una tabla o o o o Criterio de seleccin (clausula Where) Criterio de Sort(clausula Order By) Criterio de agrupamiento (clausula group By y Having) Columnas Computadas

CREANDO UN CONTROL DATAWINDOWS Un control datawindow, como todo control, va pegado en una ventana. Para crear un control datawindow y asociarlo con un objeto datawindow, seguir los siguientes pasos: o o Crear una nueva ventana (window). Seleccionar de la barra de herramientas el control datawindow (ver lista que aparece al lado izquierdo). Pegar el control en la ventana, dndole el tamao que se estime va a tener el datawindow que se desea mostrar.

o o

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 se colocar en el rea DataWindow Object Name, el nombre del datawindow objeto. Es conveniente que el nombre del datawindow control sea el mismo que el del datawindow objeto. En el script de la ventana, en la que se encuetra el control datawindow en el evento open, escribir el siguiente cdigo:

dw_coleccion. settransobject(sqlca) dw_coleccion.retrieve( )

Si la aplicacin no tiene cdigo para CONEXION a base de datos, escribir el siguiente cdigo en el evento open de la aplicacin.

CONTROLANDO LA ACTUALIZACION Para controlar la actualizacin de un datawindow, seguir los siguientes pasos: o o o o Hacer un click con el botn derecho del mouse en el control datawindow. Aparecer una lista como la que se aprecia en la figura. Seleccionar la opcin: Modify DataWindow.... A continuacin aparecer el entorno datawindow (datawindow workspace). Seleccionar el men Rows, la opcin Update Properties.

A continuacin aparecer una ventana similar a la siguiente, en la que se har un check al checkbox Allow Updates.

Hacer click en OK y el datawindow tendr la propiedad de actualizacin.

COMPONENTES DE UN DATAWINDOWS Un datawindow consta principalmente de las siguientes reas:

En otro tipo de datawindow, tambin existen reas como: Group Header : Muestra informacin acerca de los grupos de la cabecera. Group Trailer : Muestra los totales por cada grupo creado. Barra de color : Se puede cambiar el color del background, texto, etc., desde el popup del men. EVENTOS DE UN DATAWINDOWS Los eventos ms importantes del objeto datawindow son: Evento Clicked El usuario ejecuta un click con el ratn. Constructor Se ejecuta cuando ... .

Este evento est presente en casi todos los objetos de PB. 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 segn 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 carcter del contenido de un campo. Error Se produce un error de validacin 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 validacin introducidas en el datawindow object. ItemFocusChanged El usuario cambia de campo. RetrieveEnd Ha finalizado una instruccin retrieve (consulta a la base de datos). RetrieveRow Mientras se est ejecutando una instruccin retrieve y recuperamos cada una de las filas. RetrieveStart Antes de que se lance la instruccin SQL Select contra la base de datos. RowFocusChanged El foco cambia de fila. Cuidado con esta instruccin porque se ejecuta por s sola cuando hacemos un insert, un delete o un

retrieve. SqlPreview Cada vez que ejecutamos funciones de PB que afectan a la base de datos. Retrieve, Update, etc. Muy til para depurar el sql que se est generando. UpdateEnd Ha finalizado la actualizacin de la base de datos. UpdateStart Antes de que empiece la actualizacin de la base de datos. Para finalizar DataWindows, algo importante: Normalmente, primero pegas un datawindow control en la ventana, y despus le asignas un datawindow object que debes haber creado antes. Pero tambin se puede hacer sto dinmicamente a travs de un script. El atributo DataObject (de tipo string) es el que asigna el data object a la datawindow. Piensa por un momento en las posibilidades que sto ofrece.

EL LENGUAJE

POWERSCRIPT PowerBuilder tiene un ambiente de trabajo llamado PowerScript, el cual sirve para escribir el cdigo de la aplicacin. Estos comandos corresponden al lenguaje de

programacin llamado PowerScript. El lenguaje PowerScript es muy extenso y se suele recordar todas las instrucciones necesarias para poder realizar programas ms o menos complejos. El archivo de ayuda no est organizado para iniciar un aprendizaje, aunque ms adelante su uso ser de mucha utilidad. Este captulo servir para saber qu funcin se ha de utilizar, y qu nombre tiene en el archivo de ayuda. QUE ES EL SCRIPT? El script es un conjunto de uno o ms comandos del lenguaje PowerScript que se ejecutan en respuesta a la ejecucin del evento que lo invoc, es decir, siempre est asociado a un determinado evento. En los scripts se hace referencia a ventanas, controles, objetos, menes, variables y a sus atributos, los cuales pueden ser modificados. Ejem:

FACILIDADES DEL PINTOR POWERSCRIPT o Posee herramientas de edicin por medio de comandos y menes que permiten copiar, cortar, pegar, borrar, seleccionar y eliminar comentarios.

Posee listbox que contienen las variables, objetos y comandos, los cuales, al ser seleccionados, son pegados en la posicin en la que se encuentra el cursor.

PRONOMBRES USADOS POR EL POWER SCRIPT Los Pronombres usados en el PowerScript son:

This Super Parent ParentWindow TIPOS DE DATOS

referencia al objeto actual. referencia al objeto del que hereda el actual. referencia al objeto que contiene el actual. referencia a la ventana que contiene el men (solo vale para menes).

PowerScript provee 3 tipos de datos : ESTANDAR : Similares a muchos lenguajes de programacin, el PowerScript utiliza estos tipos de datos cuando declara variables o array, as tenemos los siguientes ejemplos: Tipo Descripcin

Blob Usado para almacenar imgenes textos grandes.. Boolean True o False. Char Slo carcter. ______________________________________________________________________ ___ Date Fechas. ______________________________________________________________________ ___ Datetime La fecha y la hora en un solo tipo de dato. Decimal Nmero decimal con signo de 18 dgitos. Double Punto flotante. Int Entero con signo de 4 bytes. Long Entero largo de 6 bytes.

OBJETOS DEL SISTEMA En PowerBuilder se manipula objetos como windows, menes, controles. Internamente el PB define estos tipos de objetos como un tipo de dato Ejemplo : Para definir una variable window: Para definir una variable men: window mi_window Menu mi_menu

Definir una variable commandbutton: Commandbutton mi_comando ENUMERADOS: Puede ser usado de dos formas : Como argumento en funciones y para especificar el atributo de un objeto o control. Cada tipo de dato enumerado puede ser asignado con un conjunto fijo de valores. Estos valores siempre terminan en exclamacin (!). Ejemplo : El tipo de dato Alignament, puede ser asignado a uno de los tres siguientes valores : Center!, left! y right!

TIPOS DE VARIABLES PowerScript reconoce 4 tipos de variables: Variables Globales : Cuando se quiere disponible en cualquier parte de la aplicacin. Variables de instancias(Instance): Cuando necesite tener variables que son accesadas por ms de un script dentro de un objeto, pero no necesita ser global para toda la aplicacin Variables compartidas(Shared): Las variables compartidas son asociadas con la definicin del objeto, es decir, todas las instancias de ese objeto tienen a esta variable comn. Variables locales: Cuando se necesite una variable temporal, stas son definidas en el script y slo pueden usarse en dicho script.

OPERADORES PowerBuilder soporta los siguientes tipos de operadores:

FUNCIONES MAS UTILIZADAS

FUNCIONES PARA VENTANAS: Abrir una ventana. open Abrir una ventana dentro de otra ventana del tipo mdi. opensheet Abrir una ventana envindole un parmetro. openWithParm openSheetWithParm close Abrir una ventana dentro de otra del tipo mdi envindole parmetro. Cerrar una ventana. Close(parentWindow) y close (parent) son vlidas.

BUFFERS DEL DATAWINDOWS 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 a la 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 AcceptText Provoca la validacin del campo actual si el usuario no puls tab. DBCancel Provoca la cancelacin de un retrieve( ) en curso. DeletedCount Devuelve el nmero de filas que el usuario ha borrado. DeleteRow Borra una fila. Describe Devuelve informacin muy detallada sobre la estructura de la DataWindow. Filter Ejecuta el filtro actual (vase setFilter).

GetChild Devuelve un apuntador a una DataWindow contenida dentro de otra. GetColumn Devuelve el nmero 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 nmero de fila actual. GetSQLSelect Devuelve la select de la datawindow. F U N C I O N E S 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. GetValue Devuelve un string conteniendo el valor de una columna. InserRow Inserta una fila en blanco. Modify Modifica la estructura interna de una datawindow. D E Print Imprime una datawindow. Retrieve Ejecuta una select contra la base de datos y muestra los datos en la datawindow. RowCount Cuenta las filas en una datawindow. SaveAs Salva el contenido de una dw en un fichero. Soporta diversos formatos incluyendo excel, texto, rtf y html. ScrollToRow Scrollea la datawindow hasta una fila y la hace visible (no confundir con setRow()). SetColumn Cambia el foco a una columna en concreto.

D A T A W I N D O W S

SetFilter Modifica las condiciones de filtro de una DW. SetFocus Coloca el foco en una 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 una datawindow con el objeto transaccin. Para que una datawindow funcione es imprescindible ejecutar la siguiente instruccin: NombreDw.SetTransObject(SQLCA) ShareData Hace que una datawindow comparta datos con otra (se puede conseguir un efecto de espejo). Sort Ordena una Dw con las condiciones especificadas con SetSort(). Update Graba las modificaciones en la base de datos. Ejemplos:

Hay muchas ms funciones pero stas son las que permiten crear un programa ms o menos completo que modifique una base de datos.