Manejo de eventos

Unidad IV Tpico selectos de programacin

Manejo de eventos con AWT (Abstract Windowing Toolkit)
La gestin de eventos a partir de la versin 2 de Java es conocida como modelo de delegacin de eventos, que define mecanismos coherentes y estndar para generar y procesar eventos. Una fuente genera un evento y lo enva a uno o ms oyentes o auditores, que han estado simplemente esperando hasta que reciben ese evento, y una vez recibido lo procesan y lo devuelven. En un modelo de delegacin de eventos, un auditor (u oyente) tiene que ir acompaado de una fuente para recibir la notificacin de un evento.

EVENTOS
Un evento es un objeto que describe un cambio de estado en una fuente. Se puede generar como una consecuencia de que una persona interaccione con los elementos de una interfaz grfica de usuario (GUI, por sus siglas en ingls). Algunas de las actividades que hacen que se generen eventos son presionar botn, meter un carcter mediante el teclado, seleccionar un tem (elemento) de una lista, mover las barras de desplazamiento, y hacer click con el ratn, entre otras muchas cosas. Puede ocurrir que no se provoque un evento directamente por la interaccin con una interfaz de usuario (UI). Por ejemplo, se puede generar un evento cuando se termina un cronmetro, cuando un contador pasa de un cierto valor, cuando hay un fallo de software o de hardware, o cuando se acaba una operacin. Se es libre de definir los eventos que uno considere mejores para una aplicacin.

Fuentes de evento (source)

Una fuente es un objeto que genera un evento. Esto ocurre cuando cambia de alguna manera el estado interno de ese objeto. Las fuentes pueden generar ms de un tipo de evento. Una fuente tiene que ir acompaada de auditores (oyentes (listener)) para que estos reciban notificaciones sobre el tipo especfico de evento. Cada tipo de evento tiene su propio mtodo de registro. La forma general es: public void addTipoListener(TipoListener objeto) Donde tipo es le nombre del evento y objeto es una referencia al auditor (oyente). Por ejemplo, el mtodo que registra o acompaa a un oyente de teclado es addKeyListener(). El mtodo que registra o acompaa a un oyente de movimiento de ratn es addMouseMotionListener(). Cuando ocurre un evento, se notifica a todos los oyentes registrados, que reciben una copia del objeto evento. Esto es lo que se conoce como multicasting del evento. En todos los casos, las notificaciones se envan solo a los oyentes que quieren recibirlos. Algunas fuentes slo permiten registrar un oyente. La forma general del mtodo de registro es: public void addTipoListener(TipoListener objeto) throws java.util.TooManyListenersException Cuando se produce el evento, se notifica al oyente que est registrado. Esto es conocido como unicasting del evento. Una fuente tambin puede proporcionar un mtodo que permita a un oyente eliminar un registro en un tipo especfico de evento. La forma general es: public void removeTypeListener(TypeListener objeto) Por ejemplo, para borrar un oyente de teclado, se llamara a removeKeyListener(). La fuente que genera eventos es la que proporciona mtodos para aadir o quitar oyentes de eventos del teclado o del ratn.

Maria Eugenia Puga Nathal

Pgina 1

30/01/2013

Manejo de eventos La fuente de un evento, a parte de pulsar una tecla del teclado, o el movimiento, arrastre o el pulsar del botn de ratn, son los componentes de la GUI tales como: botones, listas, campos y reas de texto, barras de desplazamiento, mens, entre otros. Y como ya se dijo, se detecta el evento de la fuente y se notifica al receptor (listener).

Auditores (oyentes o escuchas) de eventos (listener)

Un auditor u oyente es un objeto que es avisado cuando ocurre un evento. Tiene dos requisitos principales. Primero, tiene que ser registrado o ir acompaado por una o ms fuentes para recibir notificaciones sobre los tipos especficos de eventos. Segundo, tiene que implementar mtodos para recibir y procesar esas notificaciones. Los mtodos que reciben y procesan eventos se definen en un conjunto de interfaces que estn en el paquete: java.awt.event por lo que cada aplicacin que requiera del manejo de eventos tendr que importar a este paquete. Como ya se coment, para su registro: fuente.addEventoListener(TipoEvento); por ejemplo: boton.addActionListener(this); // en el objeto actual se programa el mtodo actionPerformed(ActionEvent e){} de la interfaz // ActionListener, y es donde se programan las acciones que se realizarn cuando se pulse el // botn frame.addWindowListener(new Cerrara); // se asocia a un objeto de la clase Frame, el evento de cerrar ventan, en la clase cerrar // se programa ste

Clases de eventos
Como raz en la jerarqua de clases de eventos Java est EventObject, que est en el paquete de java.util. sta es la superclase para todos los eventos. Su constructor es el siguiente: EventObject(Object src) Donde src es el objeto que genera ese evento. EventObject contiene dos mtodos: getSource() y toString(). El primero devuelve la fuente del evento. Su forma general es: Object getSource(). El segundo, devuelve el String (cadena) correspondiente al evento. La clase AWTEvent, definida dentro del paquete java.awt, es una subclase de EventObject. sta es la superclase de todos los eventos basados en AWT utilizados por el modelo de delegacin de eventos. Se puede usar su mtodo getID() para determinar el tipo de evento. Se escribe de esta manera: int getID() Existen dos tipos de eventos: De bajo nivel: representan una entrada de bajo nivel o suceso sobre un componente visual de un sistema de ventanas sobre la pantalla. Eventos de Java comprendidos en este nivel: - ComponentEvent - FocusEvent - InputEvent - KeyEvent - MouseEvent - ContainerEvent - WindowEvent Evento semntico o de alto nivel: encapsula una accin de un componente de la interfaz del usuario. Eventos de Java comprendidos en este nivel: - ActionEvent - AdjustmentEvent - ItemEvent - TextEvent

Maria Eugenia Puga Nathal

Pgina 2

30/01/2013

Manejo de eventos

Adaptadores
Cuando en un programa de Java se incluye la implementacin de una interfaz, todos los mtodos que la conforman debern desarrollarse dentro de ste, pero si alguno de esos mtodos no se necesitan en la aplicacin, aun as requieren de su implementacin, pero en este caso el cuerpo ir vaco. Las diferentes interfaces que se ofrecen en Java para la manipulacin de eventos, estn compuestas por ms de un mtodo, y en ocasiones no se requiere de su implementacin, pero debe cumplir con las reglas establecidas para la implementacin de las interfaces, por lo que deber de aparecer dentro del programa, pero con el cuerpo vaco como ya se coment al inicio de este prrafo, Java para facilitarle al usuario la implementacin de eventos, da otra alternativa, que es implementar clases adaptadoras abstractas, las cuales ya contienen el desarrollo de los mtodos contenidos en las interfaces implementadas para el manejo de eventos, pero el cuerpo de estos mtodos estn vacos, por lo que el usuario solo implementar el mtodo que necesitar, un ejemplo lo vimos en el manejo del cierre de la ventana, en este caso solo se requiere del mtodo windowClosing(), por lo que es el nico que se reestructura. En la tabla que se localiza mas abajo, se presentan las diferentes clases abstractas que permiten hacer la captacin de los diferentes eventos que se pueden generar en una aplicacin con GUI. Podemos generar una clase que herede de una clase adaptadora, en la cual solo implementemos el o los mtodos que se vayan a utilizar, por ejemplo: class cerrar extends WindowAdapter {public void windowClosing(WindowEvent e) {System.exit(0);} } Esta clase habilita el evento de cerrar la ventana. En la tabla que se presenta a continuacin, se muestran las clases de eventos principales del paquete java.awt.event Clase de evento ActionEvent AdjustmentEvent ComponentEvent ContainerEvent FocusEvent InputEvent ItemEvent Descripcin Se genera cuando se presiona un botn, se hace doble click en un elemento de una lista, o se selecciona un elemento de men. Se genera cuando se manipula una barra de desplazamiento (scrollbar). Se genera cuando un componente se oculta, se mueve, se cambia de tamao, o se hace visible. Se genera cuando se aade o se elimina un componente de un contenedor. Se genera cuando un componente gana o pierde el foco. Superclase abstracta para cualquier clase de evento de entrada de componente. Se genera cuando se hace click en un checkbox (caja de verificacin o de seleccin) o en un elemento de una lista; tambin ocurre cuando se hace una seleccin en una opcin (choice) o cuando se selecciona o deselecciona un elemento de un men de opciones. Se genera cuando se recibe una entrada desde el teclado. Se genera cuando el ratn se arrastra, se mueve, se hace click, se presiona, o se libera; tambin se genera cuando el ratn entra o sale de un componente. Se genera cuando se mueve la rueda del ratn. Se genera cuando se cambia de valor de un rea de texto o un campo de texto. Se genera cuando una ventana se activa, se cierra, se desactiva, se minimiza, se abre, o se sale de ella.

KeyEvent MouseEvent MouseWheelEvent TextEvent WindowEvent

A continuacin se presenta una tabla donde se muestra la clasificacin de sucesos, oyentes, mtodos y componentes

Maria Eugenia Puga Nathal

Pgina 3

30/01/2013

Manejo de eventos Suceso ActionEvent Oyente ActionListener Mtodos actionPerformed Componentes Button List MenuItem TextField ScrollBar Component ComponentAdapter Adaptadores

AdjustmentEvent ComponentEvent

AdjustmentListener ComponentListener

adjustmentValueChanged componentHidden componentMoved componentResized componentShown componentAdded componentRemoved focusGained focusLost itemStateChanged

ContainerEvent FocusEvent ItemEvent

ContainerListener FocusListener ItemListener

Container Component CheckBox Choice List Component Component

ContaneirAdapter FocusAdapter

KeyEvent MouseEvent

KeyListener

MouseWheelEvent TextEvent WindowEvent

keyPressed keyReleased keyTyped MouseListener mouseClicked mouseEntered mouseExited mouseReleased mousePressed MouseMotionListener mouseDragged mouseMoved MouseWheelListener mouseWheelMoved TextListener textValueChanged WindowListener windowActivated windowDesactivated windowOpened windowClosed windowClosing windowIconified windowDeiconified

KeyAdapter MouseAdapter

MouseMotionAdapter Component TextComponent Window

WindowAdapter

Cabe mencionar, que cada mtodo recibir como parmetro un objeto del tipo de suceso que puede generarse, por ejemplo: public void windowClosing(WindowEvent e) {// cuerpo} public void mouseClicked(MouseEvent e) {// cuerpo} public void mouseMoved(MouseEvent e) {// cuerpo} public void keyPressed(KeyEvent e) {// cuerpo}

Maria Eugenia Puga Nathal

Pgina 4

30/01/2013

Manejo de eventos

Clase ActionEvent
Se genera un objeto evento de la clase ActionEvent cuando se presiona un botn. Se hace doble click en un elemento de una lista, o se selecciona algo de un men. Esta clase define cuatro constantes enteras que se pueden utilizar para identificar cualquier modificador asociado con este tipo de evento: ALT_MASK CTRL_MASK META_MASK SHIFT_MASK La constante ACTION_PERFORMED puede ser utilizada para identificar eventos de accin. ActionEvent tiene tres constructores: ActionEvent(Object src, int tipo, String cmd) ActionEvent(Object src, int tipo, String cmd, int modificador) ActionEvent(Object src, int tipo, String cmd, long cuando, int modificador) Donde src es una referencia al objeto que ha generado ese evento. El tipo de evento se especifica con tipo, y la cadena corresponde a su comando cmd. El argumento modificador indica qu teclas modificadoras (ALT, CTRL, META y/o SHIFT) se han presionado cuando se ha generado el evento. El parmetro cuando especifica cuando se ocurri el evento. Object getSource() obtiene el nombre del objeto invocado String getActionCommand () obtiene el nombre del comando del objeto invocado (etiqueta) int getModifiers() generado. devuelve un valor entero que indica qu tecla modificadora se ha presionado cuando el evento se ha

long getWhen() devuelve el tiempo en el cual el evento tuvo lugar.

Clase AdjustmentEvent
Se genera un objeto evento de esta clase como resultado de un cambio sobre un scrollbar (barra de desplazamiento). Hay cinco tipos de eventos de ajuste. Esta clase define cinco constantes enteras que se pueden utilizar para identificarlos. BLOCK_DECREMENT BLOCK_INCREMENT TRACK UNIT_DECREMENT UNIT_INCREMENT El usuario hace click dentro del srollbar para decrementar un valor El usuario hace click dentro del srollbar para incrementar su valor Se arrastra el botn movible del scrollbar Se ha hecho click en el botn que est al final del scrollbar para decrementar su valor Se ha hecho click en el botn que est al final del scrollbar para incrementar su valor

Existe otra constante entera, ADJUSTMENT_VALUE_CHANGED, que indica que ha ocurrido un cambio. Esta clase tiene el siguiente constructor: AdjustmentEvent(Adjustable src, int id, int tipo, int dato) Donde src es una referencia al objeto que ha generado ese evento, el id es igual a ADJUSTMENT_VALUE_CHANGED, el tipo de evento se especifica por tipo, y su dato asociado es dato. Maria Eugenia Puga Nathal Pgina 5 30/01/2013

Manejo de eventos Adjustable getAdjustable() mtodo que devuelve el objeto que ha generado el evento. int getAdjustmentType() mtodo que devuelve una de las constantes definidas por AdjustmentEvent, que indica el tipo de ajuste generado. int getValue() mtodo que devuelve la cantidad de ajuste, por ejemplo cuando se manipula un scrollbar, este mtodo devuelve el valor representado por ese cambio.

Clase ComponentEvent
Se genera un objeto evento de esta clase cuando cambia el tamao, posicin o visibilidad de un componente. Hay cuatro tipos de eventos generados por un componente. Se definen cuatro constantes enteras que se pueden utilizar para identificarlos: COMPONENT_HIDDEN COMPONENT_MOVED Se ha ocultado el componente. Se ha movido el componente.

COMPONENT_RESIZED Se ha cambiado el tamao del componente. COMPONENT_SHOWN El componente se ha hecho visible.

ComponentEvent(Component src, int tipo) constructor de la clase Donde src es una referencia al objeto que ha generado el evento. El tipo del evento se especifica a travs de tipo. ComponentEvent es la superclase de ContainerEvent, FocusEvent, KeyEvent, MouseEvent, y WindowEvent. Component getComponent() mtodo que devuelve el componente que ha generado el evento.

Clase ContainerEvent
Se genera un objeto evento de esta clase cuando se aade o se borra un componente desde un contenedor. Hay dos tipos de eventos generados por un contenedor, y que son definidos a travs de dos constantes enteras: COMPONENT_ADDED y COMPONENT_REMOVED. stas indican que se ha aadido o se ha borrado, respectivamente, un componente desde el contenedor. Esta clase es una subclase de ComponentEvent. ContainerEvent(Component src, int tipo, Component comp) mtodo constructor, donde src es una referencia al contenedor que genera ese evento, el tipo de evento es especificado por tipo, y el componente que se ha aadido o borrado por comp. Container getContainer() mtodo que permite obtener una referencia al contenedor que ha generado el evento. Component getChild() mtodo que devuelve una referencia al componente que se ha aadido o se ha borrado desde el contenedor.

Clase FocusEvent
Se genera un objeto evento de esta clase cuando un componente est o deja de estar activo. Estos eventos se identifican mediante las constantes enteras: FOCUS_GAINED y FOCUS_LOST. Esta clase es una subclase de ComponentEvent. Constructores: FocusEvent(Component src, int tipo) FocusEvent(Component src, int tipo, boolean bandera_temporal) FocusEvent(Component src, int tipo, boolean bandera_temporal, Component otro)

Maria Eugenia Puga Nathal

Pgina 6

30/01/2013

Manejo de eventos Donde src es una referencia al componente que ha generado ese evento. El tipo del evento es especificado por tipo. El argumento bandera_temporal es puesto en true si el evento foco es temporal, en cualquier otro caso se pone en false. Un evento foco temporal se produce como resultado de otra operacin de UI. Por ejemplo, supongamos que lo que est activo tiene el foco- es un campo de texto. Si el usuario mueve el ratn para modificar un scrollbar, se pierde temporalmente el foco. El otro componente envuelto en los cambios de foco, llamado el componente opuesto, se pasa en el argumento otro. Por lo tanto, si un evento FOCUS_GAINED ocurre, otro har referencia al componente que perdi el foco. Si un evento FOCUS_LOST ocurre, otro har una referencia al componente que obtuvo el foco. Component getOppositeComponent() este mtodo devuelve el componente otro. boolean isTemporary() mtodo que indica si este cambio de foco es temporal. Regresa true si el cambio es temporal, en caso contrario, regresa false.

Clase InputEvent
Clase abstracta que es superclase para los eventos de entrada de componentes, y a su vez es una subclase de ComponentEvent. Sus subclases son KeyEvent y MouseEvent. InputEvent define ocho constantes enteras, que se pueden utilizar para obtener informacin sobre cualquier modificador asociado con el evento: ALT_MASK BUTTON2_MASK META_MASK ALT_GRAPH_MASK BUTTON3_MASK SHIFT_MASK BUTTON1_MASK CTRL_MASK Dado que generaba conflictos entre los modificadores (constantes) utilizados por eventos de teclado y de ratn con otros eventos, se hizo una extensin de estas constantes: ALT_DOWN_MASK ALT_GRAPH_DOWN_MASK BUTTON1_DOWN_MASK BUTTON2_DOWN_MASK BUTTON3_DOWN_MASK CTRL_DOWN_MASK META_DOWN_MASK SHIFT_DOWN_MASK

Los mtodos que vienen a continuacin se utilizan para cuando se desea verificar si un modificador fue presionado en el momento en que un evento se genera: boolean boolean boolean boolean boolean isAltDown() isAltGraphDown() isControlDown() isMetaDown() isShiftDown()

comprueban si esos modificadores se han presionado al mismo tiempo que se ha generado el evento. int getModifiers() mtodo que devuelve un valor que contiene todas las etiquetas de los modificadores para ese evento. int getModifiersEx() mtodo que devuelve un valor que contiene todas las etiquetas de los modificadores extendidos para ese evento.

Clase ItemEvent
Se genera un objeto evento de esta clase cuando se hace click en un checkbox o en un elemento de una lista o cuando se selecciona o se deselecciona un elemento de un men de opciones. Hay dos tipos de eventos de elementos, que se identifican por las siguientes constantes enteras: DESELECTED SELECTED Maria Eugenia Puga Nathal Pgina 7 El usuario deselecciona un elemento. El usuario selecciona un elemento. 30/01/2013

Manejo de eventos Adems se define una constante entera ITEM_STATE_CHANGED, que significa un cambio de estado. ItemEvent(ItemSelectable src, int tipo, Object entrada, int estado) mtodo constructor de la clase, donde src es una referencia al componente que ha generado ese evento, el tipo de elemento es especificado por tipo, lo que especficamente genera le evento es pasado entrada y el estado actual del elemento con estado. Object getItem() este mtodo se puede utilizar para obtener una referencia al elemento que ha generado un evento. ItemSelectable getItemSelectable() mtodo que se puede utilizar para obtener una referencia al objeto ItemSelectable que ha generado un evento. Las listas (List) y las listas desplegables (Choice) son ejemplos de elementos de UI que implementan la interfaz ItemSelectable. int getStateChange() mtodo que devuelve el cambio de estado (por ejemplo, SELECTED o DESELECTED) para el evento.

Clase KeyEvent
Se genera un objeto evento de esta clase cuando se pulsa una tecla. Hay tres clases de eventos de teclado, que estn definidos por las constantes enteras: KEY_PRESSED, KEY_RELEASED y KEY_TYPED. Los primeros dos eventos se generan cuando se presiona o se libera cualquier tecla. El tercer evento slo se da cuando se genera un carcter. KeyEvent define otras constantes enteras, por ejemplo, VK_0 a VK_9 y VK_A a VK_Z definen los caracteres ASCII equivalente de nmeros y letras maysculas. VK_F1 a VK_24 teclas de funciones, VK_NUMPAD0 a VK_NUMPAD9, las teclas numricas. Algunas otras constantes son (http://java.sun.com/javase/6/docs/api/index.html): VK_ENTER VK_DOWN VK_LEFT VK_RIGHT VK_UP VK_PAGE_UP VK_PAGE_DOWN VK_ESCAPE VK_SHIFT VK_CANCEL VK_ALT VK_CONTROL VK_AMPERSAND VK_ASTERISK VK_AT (@) VK_SPACE VK_BEGIN VK_END VK_BACK_SLASH (\) VK_BACK_SPACE VK_SLASH (/) VK_CAPS_LOCK VK_NUM_LOCK VK_CIRCUMPLEX (^) VK_EQUALS (=) VK_INSERT VK_NUMBER_SIGN (#) VK_OPEN_BRACKET ( [ ) VK_CLOSE_BRACKET ( ] ) VK_COLON (:) VK_COMMA (,) VK_PERIOD (.) VK_SEMICOLON(;) VK_LEFT_PARENTHESIS VK_RIGHT_PARENTHESIS VK_PRINTSCREEN

Las constantes VK especifican cdigos de teclas virtuales y son independientes de cualquier modificador, como control, shift o alt. KeyEvent es una subclase InputEvent. Constructores: KeyEvent(Component src, int tipo, long when, int modificador, int code) KeyEvent(Component src, int tipo, long when, int modificador, int code, char ch) Donde src es la referencia al componente que genera el evento, el tipo de evento est referenciado por tipo, el momento en que se ha presionado la tecla se pasa con when, los argumentos modificador indican qu modificador se ha presionado cuando ha ocurrido ese evento del teclado, el cdigo de tecla virtual, como VK_UP, VK_A, y as sucesivamente, se pasa con code. El carcter equivalente (si existe alguno) se pasa con ch. Si no existe ningn carcter vlido, entonces ch contienen a CHAR_UNDEFINED. Para los eventos KEY_TYPED, conde contendr a VK_UNDEFINED. Esta clase tiene varios mtodos definidos pero los ms usuales son: char getKeyChar() que devuelve el carcter que se ha tecleado int getKeyCode() que devuelve el cdigo de la tecla Si no hay disponible carcter vlido alguno, getKeyChar() devuelve CHAR_UNDEFINED. Cuando se produce un evento KEY_TYPED, getKeyCode() devuelve VK_UNDEFINED. Maria Eugenia Puga Nathal Pgina 8 30/01/2013

Manejo de eventos

Clase MouseEvent
Hay ocho eventos de ratn. Esta clase define las siguientes constantes enteras, que se pueden utilizar para identificarlos: MOUSE_CLICKED MOUSE_DRAGGED MOUSE_ENTERED MOUSE_EXITED MOUSE_MOVED MOUSE_PRESSED MOUSE_RELEASED MOUSE_WHEEL El usuario hace click con el ratn. El usuario arrastra el ratn. El ratn mete un componente. El ratn sale de un componente. Se mueve el ratn. Se presiona el ratn. Se libera el ratn La rueda del ratn fue movida

MouseEvent es una subclase de InputEvent MouseEvent(Componet scr, int tipo, long when, int modificador, int x, int y, int clicks, boolean triggersPopup) Donde src es la referencia al componente que genera el evento, el tipo de evento est referenciado por tipo, el momento en que se ha presionado la tecla se pasa con when, el argumento modificador indica qu modificador se ha presionado cuando ha ocurrido un evento del ratn, las coordenadas del ratn se pasan con x e y, el nmero de clicks se pasa con clicks, el atributo triggersPopup indica si ese evento hace que aparezca un men en esa plataforma. int getX() Devuelve la coordenada de x el ratn cuando ha ocurrido el evento. int getY() Devuelve la coordenada de y el ratn cuando ha ocurrido el evento. Point getPoint() obtiene las coordenadas del ratn, pero en este caso las almacena en un objeto de la clase Point. void translatePoint(int x, int y) traduce la posicin del evento. Los valores de x e y se aaden a las coordenadas del evento. int getClickCount() da el nmero de clicks que han hecho con el ratn para ese evento. boolean isPopupTrigger() prueba si el evento ha hecho aparecer un men en la plataforma. int getButton() devuelve el valor que representa el botn que causa el evento. El valor devuelto ser una de las constantes definidas por MouseEvent: NOBUTTON, BUTTON1, BUTTON2, BUTTON3 NOBUTTON indica que no hay botn presente o liberado. Point getLocationOnScreen() devuelve un objeto Point que contiene las dos coordenadas X y Y, stas sern relativas a la pantalla y no al componente. int getXOnScreen() devuelve la coordenada X, sta ser relativa a la pantalla y no al componente. int getYOnScreen() devuelve la coordenada Y, sta ser relativa a la pantalla y no al componente.

Clase MouseWheelEvent
Esta clase encapsula un evento de la rueda del ratn. Es una subclase de MouseEvent. Define dos constantes enteras: Maria Eugenia Puga Nathal Pgina 9 30/01/2013

Manejo de eventos WHEEL_BLOCK_SCROLL WHEEL_UNIT_SCROLL Un evento de pgina arriba o pgina abajo ocurri Un evento de lnea arriba o lnea abajo ocurri

MouseWheelEvent(Component src, int tipo, long when, int modificadores, int x, int y, int clics, boolean t, int sc, int monto, int cuenta) uno de los mtodos constructores, donde src es una regencia al objeto que genera el evento, el tipo de evento se especifica en tipo, la hora en que el evento del ratn ocurri se pasa en when, el argumento modificadores indica cuales modificadores fueron activados cuando el evento ocurri. Las coordenadas del ratn se pasan a travs de x y y, el nmero de clicks que la rueda ha rotado se pasa mediante clics, t es una bandera que indica si ese evento causa que un men popup (emergente) aparezca en esta plataforma. El valor sc debe ser WHEEL_BLOCK_SCROLL o WHEEL_UNIT_SCROLL. El nmero de unidades de scroll es pasado en monto, cuanta indica el nmero de rotaciones en que la rueda se movio. int getWheelRotation() mtodo que regresa el nmero de unidades rotacionales. Si el valor es positivo, la rueda se movi en contra de las manecillas del reloj, y si es negativo, la rueda se movi en el sentido de las manecillas del reloj. int getScrollType() devuelve WHEEL_BLOCK_SCROLL o WHEEL_UNIT_SCROLL. WHEEL_UNIT_SCROLL, se puede obtener el nmero de unidades de scroll llamando al mtodo: int getScrollAmount() Si el tipo es

Clase TextEvent
Se genera mediante campos de texto y reas de texto cuando el usuario o el programa introducen caracteres. Se define la contante entera TEXT_VALUE_CHANGED. TextEvent(Object src, int tipo) donde src es la referencia al componente que genera el evento, el tipo de evento est referenciado por tipo. El objeto TextEvent no incluye los caracteres que ya estn en el componente de texto que ha generado el evento, sino que el programa es el que tiene que utilizar otros mtodos asociados con el componente de texto para recuperar la informacin.

Clase WindowEvent
Hay diez tipos de eventos de ventanas. Se definen constantes enteras que se pueden utilizar para identificarlos: WINDOW_ACTIVATED WINDOW_CLOSED WINDOW_CLOSING WINDOW_DEACTIVATED WINDOW_DEICONIFIED WINDOW_GAINED_FOCUS WINDOW_ICONIFIED WINDOW_LOST_FOCUS WINDOW_OPENED WINDOW_STATE_CHANGED Se ha activado la ventana. Se ha cerrado la ventana. El usuario ha pedido que se cierre la ventana. La ventana ha dejado de estar activa. Se ha mostrado la ventana tras pulsar su icono. La ventana ahora est en foco de entrada. Se ha minimizado la ventana a un icono. La ventana ha perdido el foco de entrada. Se ha abierto la ventana. El estado de la ventana ha cambiado.

WindowEvent es una subclase de ComponentEvent.

Maria Eugenia Puga Nathal

Pgina 10

30/01/2013

Manejo de eventos Constructores: WindowEvent(Window src, int tipo) // ste es el ms bsico WindowEvent(Window src, int tipo, Window otro) WindowEvent(Window src, int tipo, Window otro, int deEstado, int aEstado) Donde src es la referencia al componente que genera el evento, el tipo de evento est referenciado por tipo, otro especifica la ventana opuesta cuando un evento de foco o activacin ocurre. El parmetro deEstado especifica el estado anterior de la ventana, y aEstado el nuevo estado que tendr cuando un cambio de estado de ventana ocurre. Window getWindow() devuelve el objeto Window que ha generado el evento. Window getOppositeWindow() devuelve la ventana contraria (cuando un evento de foco o activacin ha ocurrido). int getOldState() devuelve el estado anterior de la ventana. int getNewState() devuelve el estado actual de la ventana.

Ejemplos de componentes que pueden generar eventos

Origen de evento Button Checbox Choice List MenuItem Scrollbar TextComponent Window Descripcin Genera eventos de accin (ActionEvent) cuando se presiona el botn. Genera eventos de elemento (ItemEven) cuando se selecciona o deselecciona un checkbox. Genera eventos de elemento (ItemEven) cuando se cambia una opcin (choice). Genera eventos de accin (ActionEvent) cuando se hace doble click sobre un elemento; genera eventos de elemento (ItemEvent) cuando se selecciona o se deselecciona un elemento. Genera eventos de accin (ActionEvent) cuando se selecciona un elemento de men; genera eventos de elemento (ItemEvent) cuando se selecciona o deselecciona un elemento de un men de opciones. Genera eventos de ajuste (AdjustmentEvent) cuando se manipula el scrollbar. Genera eventos de texto (TextEvent) cuando el usuario introduce un carcter. Genera eventos de ventana (WindowEvent) cuando una ventana se activa, se cierra, se desactiva, se minimiza, se maximiza, se abre o se sale de ella.

Interfaces de auditores (listener) de eventos

En la tabla que se presenta a continuacin, se muestran las interfaces listener (auditor, oyente) principales del paquete java.awt.event Oyente (listener) ActionListener AdjustmentListener ComponentListener Descripcin Define un mtodo para recibir eventos de accin. Define un mtodo para recibir eventos de ajuste. Define cuatro mtodos para reconocer cundo se oculta, se mueve, se cambia de tamao o se muestra un componente. Define dos mtodos para reconocer cundo se aade o se elimina un componente de un contenedor. Define dos mtodos para reconocer cundo un componente gana o pierde el foco del teclado. Define un mtodo para reconocer cundo cambia de estado un elemento. Pgina 11 Mtodos actionPerformed(ActionEvent e) adjustmentValueChanged (AdjustmentEvent e) componentHidden(ComponentEvent e) componentMoved(ComponentEvent e) componentResized(ComponentEvent e) componentShown(ComponentEvent e) componentAdded(ContainerEvent e) componentRemoved(ContainerEvent e) focusGained(FocusEvent e) focusLost(FocusEvent e) itemStateChanged(ItemEvent e)

ContainerListener FocusListener ItemListener

Maria Eugenia Puga Nathal

30/01/2013

Manejo de eventos KeyListener MouseListener Define tres mtodos para reconocer cundo se presiona, se libera o se golpea una tecla. Define cinco mtodos para reconocer cundo se presiona o libera un botn del ratn, se hace clic con l, o el ratn entra en un componente o sale de l Define dos mtodos para reconocer cundo se arrastra o se mueve el ratn. Define un mtodo para reconocer cundo la rueda del ratn se mueve. Define un mtodo para reconocer cundo cambia un valor de texto. Define dos mtodos para reconocer cundo una ventana gana o pierde foco de entrada. Define siete mtodos para reconocer cundo una ventana se activa, se cierra, se desactiva, se minimiza, se maximiza, se abre o se sale de ella. keyPressed(KeyEvent e) keyReleased(KeyEvent e) keyTyped(KeyEvent e) mouseClicked(MouseEvent e) mouseEntered(MouseEvent e) mouseExited(MouseEvent e) mouseReleased(MouseEvent e) mousePressed(MouseEvent e) mouseDragged(MouseEvent e) mouseMoved(MouseEvent e) mouseWheelMoved(MouseWheelEvent e) textValueChanged(TextEvent e) windowGainedFocus (WindowEvent e) windowLostFocus(WindowEvent e) windowActivated(WindowEvent e) windowDesactivated(WindowEvent e) windowOpened(WindowEvent e) windowClosed(WindowEvent e) windowClosing(WindowEvent e) windowIconified(WindowEvent e) windowDeiconified(WindowEvent e)

MouseMotionListener MouseWheelListener TextListener WindowFocusListener WindowListener

Ejemplos: eventos del ratn

La clase EventosRaton hereda de la clase Frame e implementa los mtodos de las interfaces: MouseListener, MouseMotionListener. Lo nico que hace es mostrar en una etiqueta los diferentes eventos del ratn y la posicin de ste. import java.awt.*; import java.awt.event.*; // se importa el paquete para el manejo de eventos public class EventosRaton extends Frame implements MouseListener, MouseMotionListener { Label edo; // declara un objeto de la clase Label (etiqueta) public EventosRaton() // mtodo constructor {super ("ejemplo de eventos del raton"); // llama a la superclase (Frame) y pone titulo al Frame edo=new Label(); // crea el objeto edo, que es una instancia de la clase Label (etiqueta) add(edo,BorderLayout.SOUTH); // aade la etiqueta al Frame addMouseListener(this); // activa el escucha de los eventos del raton addMouseMotionListener(this); // activa el escucha de los eventos del raton setSize(600,600); // tamao del Frame setVisible(true); // hace visible al Frame } // mtodos que estn contenidos en la interface MouseListener, invocados por el mtodo escucha // addMouseListener(this); // e.getX(),e.getY(), obtienen las coordenadas del raton public void mouseClicked(MouseEvent e) { edo.setText("click "+e.getX()+","+e.getY()); } public void mousePressed(MouseEvent e) { edo.setText("presiono "+e.getX()+","+e.getY()); }

Maria Eugenia Puga Nathal

Pgina 12

30/01/2013

Manejo de eventos public void mouseReleased(MouseEvent e) { edo.setText("suelto "+e.getX()+","+e.getY()); } public void mouseEntered(MouseEvent e) { edo.setText("entro "+e.getX()+","+e.getY()); } public void mouseExited(MouseEvent e) { edo.setText("salgo "+e.getX()+","+e.getY()); } // mtodos que estn contenidos en la interface MouseMotionListener, invocados por el mtodo escucha // addMouseMotionListener(this); public void mouseDragged(MouseEvent e) { edo.setText("arrastro "+e.getX()+","+e.getY()); } public void mouseMoved(MouseEvent e) { edo.setText("muevo "+e.getX()+","+e.getY()); } public static void main (String arg[]) {EventosRaton er=new EventosRaton(); er.addWindowListener(new WindowAdapter() {public void windowClosing(WindowEvent e) {System.exit(0);} }); } } Este es el mismo ejemplo anterior, pero le agregue algunas cosas, como por ejemplo, que cambie de color el fondo segn el evento generado, y que cuando se arrastre el ratn lo siga la cadena H o o o o l a ! ! ! import java.awt.*; import java.awt.event.*; public class EventosRaton2 extends Frame implements MouseListener, MouseMotionListener { Label edo; int x, y; public EventosRaton2() {super ("ejemplo de eventos del raton"); edo=new Label(); add(edo,BorderLayout.SOUTH); addMouseListener(this); addMouseMotionListener(this); setSize(600,600); setVisible(true); x=y=0; } // con el metodo setBackground() cambio de color las areas libres del Frame public void mouseClicked(MouseEvent e) { edo.setText("click"+e.getX()+","+e.getY());setBackground(Color.pink); } public void mousePressed(MouseEvent e) { edo.setText("presiono"+e.getX()+","+e.getY());setBackground(Color.red); } public void mouseReleased(MouseEvent e) { edo.setText("suelto"+e.getX()+","+e.getY());setBackground(Color.blue); } public void mouseEntered(MouseEvent e) { edo.setText("entro"+e.getX()+","+e.getY());setBackground(Color.black); } public void mouseExited(MouseEvent e) { edo.setText("salgo"+e.getX()+","+e.getY());setBackground(Color.yellow); }

Maria Eugenia Puga Nathal

Pgina 13

30/01/2013

Manejo de eventos public void mouseDragged(MouseEvent e) { edo.setText("arrastro"+(x=e.getX())+","+(y=e.getY()));setBackground(Color.green); repaint(); } public void mouseMoved(MouseEvent e) { edo.setText("muevo"+e.getX()+","+e.getY());setBackground(Color.gray); } public void paint(Graphics g) {g.drawString("H o o o o l a ! ! !",x,y); } public static void main (String arg[]) {EventosRaton2 er=new EventosRaton2(); er.addWindowListener(new WindowAdapter() {public void windowClosing(WindowEvent e) {System.exit(0);} }); } } Pueden crear la clase siguiente, y solo generar un objeto de ella en las aplicaciones y ya tienen incorporado el evento para cerrar la ventana grfica. import java.awt.event.*; public class CerrarVentana extends WindowAdapter {public void windowClosing(WindowEvent e) {System.exit(0);} } El ejemplo que se muestra a continuacin es un applet, en el cual cada vez que arrastramos el raton se dibuja una lnea, y una vez que terminado de hacerlo, desaparece sta. En este ejemplo se crea un objeto annimo de la clase CerrarVentana, adems de implementar el mtodo main() para que la clase se comporte tanto como un applet como una aplicacin independiente. import java.awt.*; import java.applet.*; import java.awt.event.*; public class Linea extends Applet implements MouseListener, MouseMotionListener {int x1=0, y1=0; int x2=0, y2=0; boolean draw; public void init() // si se tratara de una clase que hereda de clase Frame y no de Applet, ste sera el mtodo constructor {addMouseListener(this); addMouseMotionListener(this); draw=false; } // los mtodos que vienen a continuacin, quedan con el cuerpo vaco ya que no se utilizaran en esta aplicacin, pero como // indicamos en la clase que se va a implementar las interfaces MouseListener y MouseMotionListener, es necesario // implementar los mtodos correspondientes a cada interface, se necesiten o no en la aplicacin, si no se necesitan quedan // con el cuerpo vaco como los casos siguientes: // mtodos de la interface MouseListener public void mouseEntered(MouseEvent e){} public void mouseExited(MouseEvent e){}

Maria Eugenia Puga Nathal

Pgina 14

30/01/2013

Manejo de eventos public void mouseClicked(MouseEvent e){} public void mousePressed(MouseEvent e) {x2=e.getX(); y2=e.getY(); draw=true; } public void mouseReleased(MouseEvent e) {draw=false;} // interface MouseMotionListener, sta contiene solo dos mtodos, los cuales si se utilizarn en este ejemplo, por lo tanto // el cuerpo no estar vaco public void mouseDragged(MouseEvent e) {x1=e.getX(); y1=e.getY(); repaint(); } public void mouseMoved(MouseEvent e) {showStatus("Moviendo mouse en: "+e.getX()+","+e.getY());} public void paint(Graphics g) {if (draw) {g.drawLine(x1,y1,x2,y2);} } // opcional, ya que es un applet, se pone esto si quieren que se ejecute tambin como una aplicacin. public static void main (String arg[]) {Frame f=new Frame("Otro ejemplo de eventos de raton"); Linea linea=new Linea(); f.add(linea); linea.init(); f.addWindowListener(new CerrarVentana()); // se crea un objeto annimo de la clase CerrarVentana f.setSize(600,600); f.setVisible(true); } } Cdigo de la pgina html <html> <applet code=Linea.class width=600 height=600> </applet> </html> Mismo ejemplo que el anterior, la diferencia es que en ste se implementan los dos mtodos de la interface MouseMotionListener y en lugar de implementar los mtodos de la interface MouseListener, se implementan solo los mtodos necesarios haciendo uso de la clase abstracta MouseAdapter, mtodos a iplementar: mousePressed(), mouseReleased(). import java.awt.*; import java.applet.*; import java.awt.event.*; public class LineaVer2 extends Applet implements MouseMotionListener {int x1=0, y1=0; int x2=0, y2=0; boolean draw;

Maria Eugenia Puga Nathal

Pgina 15

30/01/2013

Manejo de eventos public void init() {addMouseListener(new MouseAdapter() // se implementan los mtodos de la clase abstracta MouseAdapter { public void mousePressed(MouseEvent e) {x2=e.getX(); y2=e.getY(); draw=true; } public void mouseReleased(MouseEvent e) {draw=false;} } ); addMouseMotionListener(this); draw=false; } //mtodos de la interface MouseMotionListener public void mouseDragged(MouseEvent e) {x1=e.getX(); y1=e.getY(); repaint(); } public void mouseMoved(MouseEvent e) {showStatus("Moviendo mouse en: "+e.getX()+","+e.getY());} public void paint(Graphics g) {if (draw) {g.drawLine(x1,y1,x2,y2);} } // opcional, ya que es un applet, se pone esto si quieren que se ejecute tambin como una aplicacin. public static void main(String arg[]) {Frame f=new Frame(); LineaVer2 linea=new LineaVer2(); f.add(linea); linea.init(); f.setSize(600,600); f.setVisible(true); f.addWindowListener(new CerrarVentana()); } } Pgina html para este ejemplo: <html> <applet code="LineaVer2.class" width=600 height=600> </applet> </html>

Clase Point
Hace referencia a la localizacin de un punto grfico (pixel), contiene dos valores de acceso pblico x e y. Mtodos constructores: new Point(); new Point(int x, int y); new Point(new (Point p)); Variables de instancia: int x; Maria Eugenia Puga Nathal Pgina 16 30/01/2013

Manejo de eventos int y; Point p=new Point(); p.x p.y algunos mtodos: Point punto=new Point(); boolean punto.equals(Point p); // compara dos puntos punto.move(int x, int y); // mueve el punto a otra posicin punto.setLocation(Point p); punto.setLocation(int x, int y); // colocar el punto en otra posicin punto, translate(int dx, int dy); // cambia las coordenadas del punto mediante la adicin de dx y dy a sus coordenadas x e y, // respectivamente.

Clase Dimension
Contienen dos valores de acceso pblico, width y height Mtodos constructors: new Dimension(); new Dimension(int width, int heoght); new Dimension(Dimension d); Variables de instancia: int width; int height; algunos mtodos: Dimension dim=new Dimension(); boolean dim.equals(Dimension d); dim.setSize(Dimension d); dim.setSize(int width, int height); //ajusta los valores de altura y anchura del objeto a los especificados

Ejemplo de la clase Point

Se crea una clase que hereda todas las caractersticas y atributos de la clase Frame, en este ejemplo se hace uso del evento del ratn arrastrar ratn (mouseDragged), y de la incorporacin de una etiqueta (componente) haciendo uso de la clase Label. El Frame tiene por definicin del administrador BorderLayout, el cual divide la ventana en cinco reas: Norte, Sur, Este, Oeste, y Centro, por lo que cuando se va a incorporar un componente, administrador o contenedor se le tendr que indicar en que parte ubicarlo, para este caso se le indica que la etiqueta la coloque en la parte sur (add(new Label("arrastrar el raton para dibujar"),BorderLayout.SOUTH);), el manejo del evento del ratn, se programa a travs de la clase abstracta MouseMotionAdapter, la cual solo permite redisear los mtodos que se utilizarn en la aplicacin, a diferencia de que si se hubiese hecho con la interfaz MouseMotionListener. // este programa permite dibuja, para ello hay que arrastrar el ratn, una vez que agotamos los // puntos permitidos, deja de dibujar el raton. import java.awt.*; import java.awt.event.*; // importa el paquete para el manejo de eventos public class Pintar extends Frame { int contador=0; Point [] p=new Point[1000]; // se establece la cantidad maxima de puntos a dibujar public Pintar() // mtodo constructor, si se tratar de un applet, este seria el mtodo init() {super ("Pizarra de dibujo electronica"); // llama a la super clase (Frame) y pone titulo al frame add(new Label("arrastrar el raton para dibujar"),BorderLayout.SOUTH); // incorpora la etiqueta al Frame Maria Eugenia Puga Nathal Pgina 17 30/01/2013

Manejo de eventos addMouseMotionListener( new MouseMotionAdapter() // se programa la captura del evento del ratn { public void mouseDragged(MouseEvent e) //cada vez que se arrastra el raton se va obteniendo la coordenada para despues dibujar ese punto { if (contador<p.length) { p[contador]=e.getPoint(); contador++; repaint(); } } } ); setSize(600,600); // se establece el tamao del Frame setVisible(true); // se establece que el Frame sea visible, si se enva false como argumento, no se visualiza el Frame } public void paint(Graphics g) { super.paint(g); // se llama al metodo paint de la superclase for(int i=0;i<p.length && p[i]!=null;i++) {g.fillOval(p[i].x,p[i].y,4,4);} } public static void main (String arg[]) {Pintar pizarra=new Pintar(); pizarra.addWindowListener(new WindowAdapter() {public void windowClosing(WindowEvent e){System.exit(0);}}); } }

Ejemplos de eventos del teclado

El siguiente applet, muestra en la barra de estado, cuando se presiona o se suelta una tecla: import java.awt.*; import java.awt.event.*; import java.applet.*; public class teclas1 extends Applet implements KeyListener {String msg=""; int x=10,y=20; public void init() {addKeyListener(this); requestFocus(); } public void keyPressed(KeyEvent e) {showStatus("se presiono una tecla");} public void keyReleased(KeyEvent e) {showStatus("se solto una tecla");} public void keyTyped(KeyEvent e) {msg+=e.getKeyChar(); repaint(); } public void paint(Graphics g) {g.drawString(msg,x,y);} } Pgina html para este ejemplo: /* <html> <applet code="teclas1.class" width=300 height=300> </applet> </html> */ Maria Eugenia Puga Nathal Pgina 18 30/01/2013

Manejo de eventos El siguiente applet presenta un mensaje correspondiente a la tecla presionada import java.awt.*; import java.awt.event.*; import java.applet.*; public class teclas2 extends Applet implements KeyListener {String msg=""; int x=10,y=20; public void init() {addKeyListener(this); requestFocus(); } public void keyPressed(KeyEvent e) {showStatus("se presiono una tecla"); switch(e.getKeyCode()) {case KeyEvent.VK_F1:msg+=" F1 ";break; case KeyEvent.VK_F3:msg+=" F3 ";break; case KeyEvent.VK_F5:msg+=" F5 ";break; case KeyEvent.VK_PAGE_DOWN:msg+=" abajo ";break; case KeyEvent.VK_PAGE_UP:msg+=" arriba ";break; case KeyEvent.VK_LEFT:msg+=" flecha izq ";break; case KeyEvent.VK_RIGHT:msg+=" flecha der ";break; } repaint(); } public void keyReleased(KeyEvent e) {showStatus("se solto una tecla");} public void keyTyped(KeyEvent e) {msg+=e.getKeyChar(); repaint(); } public void paint(Graphics g) {g.drawString(msg,x,y);} } Pgina del ejemplo anterior. /* <html> <applet code="teclas2.class" width=300 height=300> </applet> </html> */

Maria Eugenia Puga Nathal

Pgina 19

30/01/2013