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) 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. Argument

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()