Funciones principales de un Datawindows en Power Builder

SetTransObject
Hace que un control DataWindow use un objeto de transaccin especificado por el
programador. El objeto de transaccin proporciona la informacin nesecesaria para
comunicarse con la Base de Datos. Retorna -1 si ha ocurrido un error.
Sintaxis:
Dwn. Settransobject(Transaccin)
Argument

Description
El nombre del Control data window, con el cual se desea usar un
Dwn
objeto de transaccin.
Transaccin Nombre del Objeto de transaccin, por defecto es SQLCA.
Generalmente se establece el objeto de transaccin en el evento Open de la ventana que
contiene el control DataWindow.
En resumen el SettransObject(SQLCA) asocia el objeto transacin con el control
DataWindow.
Ejemplo:
DwnSoftware.settransobject(SQLCA)
InsertRow
Sintaxis:
Dwn.InsertRow(fila)
Argument
Dwn
Fila

Descripcion
El nombre del control DataWindow en el cual se desea insertar una
fila.
Un entero Largo (long) que identifica la fila antes de la cual desea
insertar una fila nueva. Si el valor es cero insertar al final de la
tabla.

Ejemplo:
DwnSoftware.InsertRow(0)
Retrieve()
Recupera todas las filas de una tabla de la BDD en un control DataWindow, Si incluyen
argumentos, estos son usados por los argumentos de recuperacion de la sentencia SQL

SELECT del objeto DataWindow. Retorna el nmero de filas recuperadas, -1 si ocurre

un error.
Sintaxis
Dwn.Retrieve({Arg1, Arg2,})
Argument Descripcion
Arg1, Arg2 Argumentos de recuperacion, de la tabla de BDD
Ejemplo:
DwnSoftware.Retrieve(C001)
SetRowFocusIndicator
Especifica el indicador visual que identifica la fila actual en un control DataWindow.
Sintaxis Dwn.SetRowFocusIndicator (Indicador)
Indicador El indicador visual para la fila actual, los valores validos son
Off!
Sin indicador.
FocusRect! Un rectangulo de puntos alrededor de la fila.
Hand!
Un dedo indice.
El nombre de un Picture Control.
SelectRow
Selecciona la fila especificada en el control de un DataWindows.
Sintaxis Dwn.SelectRow (Fila, Boolean)
Ejemplo:
DwnSoftware.SelectRow(0,False) // desactiva la fila anterior
DwnSoftware.SelectRow(15,true) // resalta toda la fila 15
SetItem
Establece el valor en una fila y columna especificada, un valor dentro del datawindow,
retorna -1 si ocurre un error.
Sintaxis DwnSoftware.Setitem (Fila, columna/campo, valor)
Ejemplo:
Dwn.SetItem(5, "sueldo",670)

En la fila 5, en el campo sueldo se asigna 670.

Tambin en vez del nombre de campo, puede ser el nmero de campo de acuerdo como
ha sido seleccionado en el objeto DataWindow.
GetItemString
Obtiene datos de tipo cadena de un buffer especificado de un control DataWindow.
SintaxisDwn.GetitemString (Fila, Columna)
Ejemplo
String cad
Cad=DwnSoftware.GetItemString(3, "sfw_Nombre")
Extrae el dato que se encuentra en el campo sfw_nombre, en la fila 3, dependiendo del
tipo de dato que se va extraer tenemos:
Dwn.GetitemNumber (Fila,
columna)
Dwn.GetitemDecimal (Fila,
columna)
Dwn.GetitemDate (Fila,
columna)
Dwn.GetitemTime (Fila,
columna)
Dwn.GetitemDateTime (Fila,
columna)

Cuando el campo es de manera general

numrico, puede ser real o entero.
Cuando el dato a extraer es exclusivamente
decimal o real.
Si el campo es de tipo fecha.
Si el campo es de tipo hora.
Cuando el campo es de tipo fecha y hora.

Ejemlo: Capturar en variables, sueldo del empleado, su edad y fecha de nacimiento del
empleado, cuya posicin se encuentre en la fila nmero 3.
Int edad
Dec Sbas
Date Fenac
Edad= DwnEmpleado.GetItemNumber(3,"emp_Edad")
Sbas= DwnEmpleado.GetItemDecimal(3, "emp_Sbas")
Fenac=DwnEmpleado.GetItemDate(3,"emp_Fenac")
Nombre del campos en la tabla.

Gettext
Obtiene el valor de un control de edicion en la fila y columna actuales, antes que este
sea aceptado.
Sintaxis dwn.Gettext ()
Por ejemplo si este radio button se encuentra dentro del DataWindow, y al seleccionar
una de estas opciones se desea saber su valor seleccionado basta emplear:
String Tmoneda
Tmoneda = DwnSalario.Gettext()
Setsort
Especifica, el criterio de ordenamiento para un DataWindow, retorna 1 si tuvo xito y -1
si se encontro un error.
SintaxisDwn.SetSort (campo1 [A|D])
Ejemplo:
DwnEmpleado.setsort()
Dwn.Sort()
Ejecuta la clasificacin con un previo criterio de seleccin
SintaxisDwn.Sort ()
Ejemplo:
DwnEmpleado.SetSort("emp_ape A, #2 D") // ordena apellido y sueldo asumiendo
// que el #2 sea el campo sueldo.
DwnEmpleado.Sort() // Procede al ordenamiento.
GetRow
Retorna el nmero de la fila actual de un DataWindow, como un valor Long,
Retorna 0 si no hay fila activa y -1 si se ha producido un error grave.
SintaxisDwn.GetRow ()
SetRow

Establece la fila deseada, mueve el cursor a la fila especificada, pero no hace Scroll en
el DataWindow.
SintaxisDwn.SetRow (Fila)
ScrollToRow
Hace un Scroll en un DataWindow, hasta alcanzar la fila especificada.
ScrollToRow cambia la fila actual pero no la columna actual. Retorna 1 si hubo xito, 1 en caso contrario. Scrolltorow no ilumina la fila a la cual se hace scroll.
Sintaxis Dwn.ScrolltoRow(fila)
Si la fila toma un valor mayor que el nmero total de la fila, se hace scroll a la ltima
fila.
RowCount
Obtiene el nmero de filas que se encuentran disponibles en un DataWindow
Sintaxis Dwn.RowCount()
ScrollToRow
Causa que el control se deslice a la fila especificada, cambiando la fila actual, a donde
se le indique.
Sintaxis Dwn.Scrolltorow(fila)
ScrollToPriorRow
Se desliza a la fila previa, sin cambiar la columna activa
Sintaxis Dwn.ScrollPriorRow(fila)
ScrollNextRow
Se desliza a la siguiente fila.
Sintaxis Dn.ScrollNextRow(fila)
DeleteRow
Suprime la fila especificada del control DataWindow, se actualiza directamente la tabla
enlazada al control.
Sintaxis Dwn.DeleteRow(fila)

Si la fila es igual a cero, elimina la fila activa donde se encuentra el puntero, cada vez
que se emplee esta sentencia, se tiene que actualizar el DataWindow ejemplo:
Dwn.deleteRow(8) // elimina la fila nmero 8
Dwn.Update() // actualiza la base de datos enlazada
DeletedCount
Retorna el nmero de filas que hayan sido suprimidas desde el control DataWindow pero que todavia no hayan sido
actualizadas en la tabla de la BDD asociada.

SintaxisDwn.DeletedCount()
Ejemplo:
Long Nf
Nf=Dwn.DeletedCount()
Update
Se envia a la base de datos todas las inserciones, eliminaciones y actualizaciones del control DataWindow, retorna 1 si tuvo
xito, -1 si ocurrio un error.

SintaxisDwn.Update()