Esta clase es la principal de todo objeto de T-Gtk.
CONSTRUCTOR
No tiene un constructor.
DESCRIPTION
GObject es la piedra angular de GNOME y es utilizada en todo GTK+, Pango, Accessibility Toolkit, y la mayoría de aplicaciones y bibliotecas de alto nivel de GNOME. Antes de GTK+ 2.0, el código GObject era parte del código base de GTK+. (El nombre de "GObject" todavía no estaba en uso; el nombre común de la clase base fue llamado GtkObject.)
Información detallada en Wikipedia http://es.wikipedia.org/wiki/GObject
STATUS
Listo
FILES
/src/gclass/gobject.prg. Librería libgclass.a
DATA
| • | pWidget, puntero al Widget. Esta DATA es usada en todas las llamadas a las funciones de GTK que precisen el puntero al widget. |
| • | bAction, bLeave, bEnter, bChange, bValid, bEnd, bLostFocus. Todas estas variables las usaremos para modificar el comportamiento de un objeto en concreto, lo que nos blindará una flexibilidad increíble, puesto que con simples codeblocks podremos establecer el comportamiento del objeto. |
METHODS
| • | Object_Empty() |
| • | Set_Valist( aValues, pWidget ) |
| • | Connect( cEvento, cMethod, pWidget, ConnectionFlags ) |
| • | Connect_After( cEvento, cMethod, pWidget ) |
| • | OnDestroy( oSender ) |
| • | OnDelete_Event( oSender ) |
| • | OnLeave( oSender ) |
| • | OnEnter( oSender ) |
METHOD Object_Empty()
ARGUMENTS
Nada.
DESCRIPTION
Constructor que permite crear un objeto de una clase determinada.
Es muy util para tratar como un objeto, los punteros a widgets de GTK+
RETURN
Self.
METHOD Set_Valist( aValues, pWidget )
ARGUMENTS
aValues. Array que contiene { propiedad, valor , ...}
pWidget. Es posible indicar el puntero del widget al que queremos aplicarle
las propiedades seleccionadas. Por defecto es al propio widget.
DESCRIPTION
Especificamos propiedades de los widgets a traves de este method.
El array aValues siempre debe de ser un numero par, puesto que toda propiedad
debe de tener un valor asociado.
RETURN
Nada.
METHOD Connect( cEvento, cMethod, pWidget )
ARGUMENTS
cEvento. Señal que queremos conectar.
cMethod. Nombre del method que queremos que se salta cuando se produzca la
señal. Por defecto cuando es NIL, internamente se saltara a un method llamada
igual al cEvento pero con las siglas "ON" delante.
pWidget. Puntero del widget al que queremos conectar la señal. Por defecto
vale el propio pWidget del objeto.
DESCRIPTION
Como sabemos , el toolkit GTK+, se le debe de conectar las señales que
deseamos controlar. Este method es el encargado de especificar que señal
queremos conectar del widget especificado y donde deseamos saltar cuando se
produzca la señal.
RETURN
Devuelve el identificativo de la señal. Aunque no suele usarse, es posible
desconectar los eventos de la señal que habiamos conectado.
METHOD OnDestroy( oSender )
ARGUMENTS
oSender. El objeto que a ocasionado el evento.
DESCRIPTION
Este evento siempre se conecta , en todos los que heredan desde gWidget,
a traves del evento Register, "destroy".
Es llamada SIEMPRE que es destruido un widget, donde aprovecharemos para
destruir la font asociada, cursores , etc...
Antes de proceder a cualquier cosa, se evaluara el codeblock bDestroy,
pasandole oSender como parametro.
RETURN Devuelve .F.
METHOD OnDelete_Event( oSender )
ARGUMENTS
oSender. El objeto que a ocasionado el evento.
DESCRIPTION
Este evento se dispara cuando queremos controlar la salida de la
aplicacion. Para ello se conecta la señal "delete_event". Se controla a partir
del codeblock bEnd, si dicho codeblock devuelve .T., indica que nos quedamos ,
si devuelve .F., destruye la ventana.
METHOD OnLeave( oSender )
ARGUMENTS
oSender. El objeto que a ocasionado el evento.
DESCRIPTION
Este evento se dispara para controlar los cursores y los mensajes en la
barra de status. Se conecta la señal "leave".
Tambien se evalua el codeblock bLeave , pasandole oSender como parametro.
METHOD OnEnter( oSender )
ARGUMENTS
oSender. El objeto que a ocasionado el evento.
DESCRIPTION
Este evento se dispara para controlar los cursores y los mensajes en la
barra de status. Se conecta la señal "enter".
Tambien se evalua el codeblock bEnter , pasandole oSender como parametro.
METHOD OnActivate( oSender )
ARGUMENTS
oSender. El objeto que a ocasionado el evento.
DESCRIPTION
Este evento se produce siempre que se halla conectado la señal "activate" al
objeto. Dentro de este method se procede a evaluar el codeblock bAction,
pasandole como parametro oSender.
RETURN Devuelve .F.
METHOD OnToggled( oSender )
ARGUMENTS
oSender. El objeto que a ocasionado el evento.
DESCRIPTION
Este evento se produce siempre que se halla conectado la señal "toggle"
al objeto. Varios son los widgets que pueden conectar este widget, como por
ejemplo los tooglebutton. Dentro de este method se procede a evaluar el
codeblock bAction, pasandole como parametro oSender. RETURN Devuelve .F.
METHOD OnFocus_In_Event( oSender )
ARGUMENTS
oSender. El objeto que a ocasionado el evento.
DESCRIPTION
Este evento se produce siempre que se halla conectado la señal "focus-in-event"
al objeto. Este se evalua cada vez que intentamos entrar al widget,
momento que aprovecharemos para evaluar el codeblock bWhen.
Si es verdadero, podemos entrar, de lo contrario, saltaremos al siguiente.
RETURN
.F.
METHOD OnFocus_Out_Event( oSender )
ARGUMENTS
oSender. El objeto que a ocasionado el evento.
DESCRIPTION
Este evento se produce siempre que se halla conectado la señal "focus-out-event"
al objeto. Este se evalua cada vez que intentamos salir del widget hacia otro,
momento que aprovecharemos para evaluar el codeblock bValid.
Si el resultado no es verdadera, no saldremos del widget, solamente saldremos,
siempre y cuando sea verdadero.
RETURN
.T. Si nos quedamos, .F. si salimos.
