Como dije en la entrada anterior, el
módulo eventos separa sus manejadores en jerarquías diferentes.
Aquí voy a explicar las jerarquías global y general.
Empezaré por el último punto.
En la entrada anterior dije, que el
modo en el que se registra un método a un evento era este:
Esto
no es totalmente cierto y lo dije solo, a titulo informativo, para
explicar la entrada. PyBta ofrece capas superiores para la conexión
de eventos.
Para
los eventos globales y generales, PyBta ofrece el módulo conexiones.
Este se separa en dos submódulos, el submódulo globales y el
submódulo generales. Dentro de ellos se encuentran, todos los
eventos separados por su categoría.
Estos
objetos se encuentran declarados dentro: pyBta/eventos/conexiones/
La
forma correcta de conectar el evento anterior, es esta:
pyBta.conexiones.generales.EventoPulsandoSobre(self.botonHola,self.saludar)
Si
se sustituye esta linea por la anterior, el programa debería
ejecutarse
de
la misma manera.
El
objeto conexión generado contiene el método, __desconectar__. Una
vez ejecutado ese método la conexión dejará de emitir.
Otra
forma de desconectar un objeto conexión, es destruyendo al objeto
conectado. Por ejemplo, si se elimina un formulario, todos los
eventos conectados a este o a un elemento contenido en el, quedarán
eliminados.
Toda
función que queramos usar como respuesta a un evento, deberá
recibir el parámetro evento. Este parámetro traerá en su interior
información referente al evento ejecutado.
Ejemplo
de función usada como respuesta a un evento:
def
saludar(self,evento):
self.etiquetaHola.etiqueta="Hola
Mundo."
El
parámetro evento, es un dato de tipo diccionario y en su interior
guarda, la clave del objeto registrado, el tipo de evento que
representa y si es requerido este diccionario también guardará
información referente al evento generado.
Aun
siendo un diccionario, el parámetro evento puede ser consultado de
esta manera:
evento.id:
es el identificador de objeto, del cual nace la señal.
Evento.tipo:
es el tipo de evento generado. Este viene en forma de constante.
Todos los eventos en PyBta tienen una constante relacionada,esas
constantes, no son más que una cadena de caracteres que
contiene el nombre del evento en mayúsculas.
Paso
a explicar aquí, todas las conexiones disponibles de este módulo.
Conexiones
globales(pyBta.conexiones.globales.)
- EventoPulsandoBoton: ocurre cada vez que se pulsa un botón del ratón, sobre una pantalla activa.
- EventoSoltandoBoton: Ocurre cada vez que se suelta un botón del ratón, sobre una pantalla activa.
- EventoIntervaloGlobal: ocurre cada vez que PyBta ejecuta una vuelta a su bucle interno.
- EventoDesplazandoCursor: Ocurre cada vez que se desplaza el cursor del ratón sobre una pantalla activa.
- EventoPulsandoTecla: ocurre cada vez que se pulsa una tecla del teclado en tiempo de ejecución.
- EventoSoltandoTecla: ocurre cada vez que se suelta una tecla del teclado en tiempo de ejecución.
- EventoRedimensionandoPantalla: si PyBta se inicio usando la constante REDIMENSIONABLE, se emitirá este evento cada vez que la ventana principal cambie su tamaño.
- EventoTrocarPantallas: ocurre cada vez que intercambiamos pantallas en tiempo de ejecución.
Esta es la
relación de eventos que se encuentran dentro de la jerarquía de
conexiones globales.
Conexiones
generales (pyBta.conexiones.generales.)
- EventoElementoEnEspera: se emite mientras el elemento conectado se encuentra en espera de que el usuario o PyBta realicen algún cambio sobre el.
- EventoEntrandoEnElemento: ocurre cada vez que el cursor del ratón entra dentro de un elemento y este se encuentra en su estado esperando.
- EventoSaliendoDelElemento: ocurre cada vez que el cursor del ratón sale de un elemento.
- EventoPulsandoSobre: se emite cada vez que pulsamos con un botón del ratón sobre un elemento.
- EventoSoltandoSobre: ocurre cada vez que soltamos el botón del ratón sobre un elemento.
- EventoDesplazandoSobre: ocurre cuando el puntero del ratón se desplaza sobre un elemento.
- EventoClick: ocurre cuando se pulsa y suelta el botón izquierdo del ratón sobre un elemento.
- EventoDobleClick: ocurre después de pulsar y soltar dos veces el botón izquierdo del ratón sobre un elemento.
- EventoPulsaYDesplaza: ocurre cuando se pulsa el botón izquierdo del ratón sobre un elemento y sin soltarlo, se empieza a desplazar el cursor sobre el.
- EventoGirandoRuedaArriba: ocurre cuando se gira la rueda del ratón hacia arriba, sobre un elemento.
- EventoGirandoRuedaAbajo: ocurre cuando se gira la rueda del ratón hacia abajo, sobre un elemento.
- EventoDesplazandoFuera: un elemento emitirá este evento, cuando el cursor del ratón se desplace por fuera de el.
- EventoPulsandoTecla: ocurre cuando se pulsa una tecla del teclado, sobre un elemento enfocado. En esta versión de PyBta, no se recomienda usar este evento al menos que sea sobre un control.
- EventoSoltandoTecla:ocurre cuando se pulsa una tecla del teclado, sobre un elemento enfocado. En esta versión de PyBta, no se recomienda usar este evento al menos que sea sobre un control.
No hay comentarios:
Publicar un comentario