Componentes Swing look and feel pluggable ( mecanismo de double buffering, transparentes.

Transcripción

1 Componentes Swing Forman parte de las Java Foundation Classes y, constituyen un conjunto de componentes de interfaz de usuario, lightweight, construídas bajo la infraestructura del AWT. Son un reemplazo lightweigth de las componentes heavyweight del AWT. Además Swing provee múltiples componentes de GUI que no están presentes en el AWT (tabbed pane, toolbar, color chooser, table, tree, dialog boxes). Proveen soporte para implementar interfaces de usuario gráficas con look and feel pluggable (las componentes Swing pueden conservar su apariencia en plataformas diferentes), tienen incorporado un mecanismo de double buffering, pueden ser transparentes.

2 Componentes Swing Swing contiene alrededor de 250 clases. Para distinguir las clases que son componentes de interfaz de usuario de aquellas que son de soporte, los nombres de las componentes Swing comienzan con J. Algunos de los paquetes que componen Swing son: javax.swing javax.swing.border javax.swing.event javax.swing.table javax.swing.tree Componentes Swing Bordes para componentes Swing Clases de eventos e interfaces listener Clases de soporte para JTable Clases de soporte para JTree

3 Componentes Swing y AWT Swing se construyó por encima del AWT. Swing usa la infraestructura provista por el AWT: objetos gráficos, colores, fonts, layout managers, etc. Todas las componentes Swing son subclase de java.awt.container (es lightweight, no tiene peer), que a su vez es subclase de java.awt.component. Swing NO usa las componentes de GUI del AWT, excepto Frame, Window y Dialog, que son las superclases de las componentes Swing, JFrame, JWindow y JDialog, respectivamente. JFrame JWindow JDialog Swing Heavyweight Components Swing Lightweight Components AWT Frame, Window, Dialog Component, Container, Graphics, Color, Font, Toolkit, Layout Managers, etc.

4 Arquitectura de las Componentes Swing Swing está basada en una versión especializada de la arquitectura Model View Controller. Las componentes Swing lightweigth comprenden los siguientes objetos: Un modelo que mantiene los datos de la componente y provee métodos para accederlos. Un UI delegate que es el responsable de pintar la componente (look) y manejar sus eventos (feel). Una componente que es subclase de JComponent. Los controllers en Java son los objetos listeners. Usualmente los listeners Swing se implementan como clases internas de los objetos UI delegate. Swing provee una API para manipular objetos de interfaz de usuario. La creación de los objetos UI delegate y de los modelos es transparente para el programador.

5 Applets y Aplicaciones Swing Las applets y aplicaciones que usan componentes Swing deben extender las clases JApplet (subclase de java.applet.applet) y JFrame (subclase de java.awt.frame), respectivamente. JApplet y JFrame soportan Swing. Se recomienda extender estas clases para implementar applets y aplicaciones que usan Swing. Todos los contenedores Swing de nivel de ventana contienen una instancia de de la clase JRootPane (JApplet, JDialog, JFrame, JInternalFrame y JWindow). Esta instancia incluye un contenedor llamado content pane (instancia de JPanel), donde estarán contenidas todas las componentes. Swing define la interface, RootPaneContainer que implementan todos los contenedores Swing mencionados. Por lo tanto, tanto JApplet como JFrame son contenedores que tienen asociado una instancia de la clase JRootPane. En el content pane del JRootPane residen todas las componentes del applet o aplicación.

6 La Clase JApplet Las componentes de GUI deben ser agregadas al content pane en vez de ser agregadas directamente al applet (como en AWT). Adicionalmente, el layout manager se establece sobre el content pane y no directamente sobre el applet Swing. El manejador de layout para JApplet es el BorderLayout. JFrame usa el mismo y de esta manera se facilita la migración de applets a aplicaciones y viceversa. Un applet obtiene una referencia a su content pane, invocando al método getcontentpane() de Japplet. Las instancias de JApplet pueden tener una barra de menúes (no era posible en las applets AWT) que se especifica mediante el método setjmenubar(jmenubar) de JApplet. También es posible agregar una barra de menú al applet, instanciando JMenu y agregando dicho objeto al content pane.

7 Ejemplo de un Applet Swing import javax.swing.*; import java.awt.*; import java.awt.event.*; public class Test extends JApplet { public void init() { Container contentpane = getcontentpane(); Icon icon = new ImageIcon("swing.gif", Una animación"); JLabel label = new JLabel("Swing!", icon, JLabel.CENTER); contentpane.add(label, BorderLayout.CENTER); } } Se agrega el label al content pane del applet Ubica el label en el centro del content pane A diferencia de Applet, las JApplet usan como layout manager de default al BorderLayout.

8 La Clase JComponent La clase JComponent es la clase base de todas las componentes Swing (lightweigth). Es la superclase de todas las componentes Swing lightweight. JComponent es subclase de java.awt.container, que a su vez es subclase de java.awt.component, por lo tanto todas las componentes Swing son contenedores AWT. JComponent provee a todas sus subclases de una amplia funcionalidad. Bordes Soporte de Accesibilidad Double buffering Debug graphics Autoscrolling Tooltips Manejo de abreviaturas

9 Bordes Todas las subclases de JComponent puede tener un borde (excepto JViewPort). Los bordes de la componentes se establecen, creando el borde deseado y luego invocando al método setborder(border) pasando como parámetro el borde previamente creado. Los bordes se dibujan adentro de la componente, pero los bordes no son componentes. import java.awt.borderlayout; import javax.swing.*; import javax.swing.border.*; public class Test extends JApplet { public void init() { JPanel panel = new JPanel(); panel.setborder(new TitledBorder("JPanel Border")); getcontentpane().add(panel, BorderLayout.CENTER); } } El applet crea un titled border que es pasado como parámetro al setborder.

10 Estilos de Bordes provistos por Swing

11 Bordes Existen distintos estilos de bordes y cada uno de ellos se corresponde con una clase en el paquete javax.swing.border. Por ejemplo: javax.swing.border.titledborder, javax.swing.border.bevelborder, etc. Un mismo borde puede ser usado para decorar diferentes componentes. Para ello Swing provee la clase BorderFactory que permite construir instancias de bordes compartidos. La clase BorderFactory provee métodos de clase que retornan instancias de todos los bordes.... Border border =BorderFactory.createRaisedBevelBorder(); Border border2 =BorderFactory.createRaisedBevelBorder(); JPanel panel.setborder(border); JPanel panel2.setborder(border2);... Usar la clase BorderFactory evita importar el paquete javax.swing.border y hace más eficiente el uso de bordes ya que la fábrica devuelve instancias compartidas (para los bordes simples). Para los bordes que tienen propiedades como títulos, las instancias son únicas. Es posible crear bordes customizados, subclaseando la clase AbstractBorder y sobreescribiendo los métodos necesarios. Usualmente se sobreescriben los métodos: paintborder, getborderinsets e isopaque (retornando true, si la componente pinta todos los pixels del borde, ya que default retorna false).

12 Double buffering El double buffering, es una técnica, que elimina el parpadeo producido cada vez que parte de ó toda una componente se actualiza en la pantalla. Las componentes Swing son double buffering, esto significa que el background se limpia y la componente se vuelve a pintar en un buffer offscreen y, luego este buffer se copia en la pantalla. El buffer offscreen es lo suficientemente grande como para poder contener todas las componentes Swing del contenedor. Las componentes se dibujan en el buffer offscreen y subsecuentemente se copian en la pantalla. La propiedad de double buffering puede ser establecida sobre una componente particular. Sin embargo, prevalece la configuración realizada por el contenedor, esto es, toda componente es automáticamente double buffer si su contenedor lo es. Las componentes Swing JRootPane y JPanel son double buffer por default.

13 Double buffering La propiedad de double buffer se hace disponible mediante los siguientes métodos de la clase javax.swing.jcomponent: public void setdoublebuffered(boolean o) public boolean isdoublebuffered() Los programas que usan componentes Swing, no necesitan hacer nada especial para soportar double buffering. Swing asegura que el tipo apropiado de objeto Graphics (imagen offscreen en caso de double buffer ó una imagen normal) será pasado como parámetro al método paint(). Por lo tanto, la componente solamente debe ocuparse de dibujar en él.

14 Componentes Opacas ó Transparentes Las componentes Swing pueden ser opacas ó parcialmente transparentes. Componente Opaca Componente Transparente Una componente que NO pinta TODOS sus bits asociados es parcialmente transparente. En otro caso, es opaca. Una componente transparente cada vez que es repintada primero debe repintar la porción del contenedor que intercepta.

15 La javax.swing.jcomponent provee los métodos: public void setopaque() Componentes Opacas ó True, la componente pinta todos sus bits False, la componente no garantiza que se pinten todos sus bits public boolean isopaque() Transparentes El sistema de pintado de Swing usa la propiedad de no transparente ú opaco de una componente para determinar si es necesario repintar ó no a sus ancestros (ante un pedido de actualización de la componente). La mayoría de las componentes Swing por default son opacas. Ej: A los Pushbuttons, ser transparentes les permite tener apariencia no-rectangular.

16 El método paint() en Swing De la misma forma que las componentes AWT, las Swing son mostradas en la pantalla invocando el método paint(graphics g) de la clase javax.swing.jcomponent. El método paint(graphics g) de JComponent considera que la componente puede ser double buffer, puede tener borde y que puede contener otras componentes. protected void paintcomponent(graphisc g) protected void paintborder(graphisc g) protected void paintchildren(graphisc g) Estructura del método paint(graphics g) El programador que usa Swing, NO debe sobreescribir el método paint(), solamente se debe sobreescribir el método paintcomponent().

17 El método paint() en Swing Como ya hemos visto, las componentes Swing tienen asociado un objeto UI delegate, que es el responsable del look and feel de la componente. Por lo tanto, el pintado de las componentes estándares se delega en este objeto. Esto ocurre en el método paintcomponent(). paint() paintcomponent() ui.update() ui.paint() Si la componente es opaca, se limpia el background y luego se invoca al paint() de la componente

18 Pintar Componentes Swing Originado por el ancestro heavyweigth Se invoca al método Container.paint() Se convierte el objeto Graphics en un objeto Graphics offscreen apropiado (si double buffer está habilitado). Se invoca al paintcomponent() sobre la componente (usando la imagen offscreen si double buffer está habilitado) Se invoca al paintborder() sobre la componente (usando la imagen offscreen si double buffer está habilitado) Se invoca al paintchildren() sobre la componente (usando la imagen offscreen si double buffer está habilitado). Este método usa el rectángulo de dibujo de la componente, la propiedad de transparencia para determinar sobre que descendientes invocar al paint() Si double buffer está habilitado, se copia la imagen offscreen sobre la pantalla Para cada una de las componentes lightweigth

19 Pintar Componentes Swing Originado por una invocación al JComponent.repaint() Usa el rectángulo de dibujo de la componente y la propiedad de transparencia para determinar la componente raíz a partir de donde comienza la operación de pintado Se convierte el objeto Graphics en un objeto Graphics offscreen apropiado (si double buffer está habilitado en la componente raíz) Se invoca al paint () sobre la componente raíz (luego se realizan los pasos 3, 4 y 5) Si double buffer está habilitado sobre componente raíz, se copia la imagen offscreen sobre la pantalla

20 Pluggable Look and Feel La clase javax.swing.uimanager maneja información acerca del look and feel de las applets y aplicaciones Swing. Provee acceso a la siguiente información y servicios, mediante métodos de clase: Establece el look and feel de applets ó aplicaciones Provee acceso a los valores del look anf feel actual Carga propiedades para Swing de un archivo de propiedades El método UIManager.setLookAndFeel() establece el valor actual del look and feel. Los valores posibles son: javax.swing.plaf.motif.motiflookandfeel, javax.swing.plaf.motif.windowslookandfeel javax.swing.plaf.motif.metallookandfeel javax.swing.plaf.motif.maclookandfeel

21 Soporte de Accesibilidad El objetivo del soporte de accesibilidad es hacer que el software sea accesible para todas las personas. JFC soporta accesibilidad de tres formas diferentes: Look and Feel Pluggable API de Accesibilidad Servicios de Accesibilidad Swing fue diseñado para soportar look & feel pluggable. De esta forma es posible implementar look and feels alternativos para las componentes. Por ejemplo, reemplazar el look and feel visual de las componentes por uno basado en voz, para usuarios con problemas de visión ó adaptar las componentes que tienen aspectos de audio con un look and feel que muestre subtítulos cada vez que se reproduce el audio (para usuarios con dificultades auditivas). La API de Accesibilidad, permite que las componentes de interfaz de usuario le brinden información a las tecnologías que ayudan a usuarios discapacitados. La clase AccesibleContext define un conjunto básico de información que la componente debe proveer.

22 Soporte de Accesibilidad La clase AccesibilityContext provee métodos como: getaccesiblerole(): identifica el rol de la componente de interfaz de usuario que a su vez identifica el tipo de componente. getaccesiblename(), getaccesibledescription(): obtiene información específica sobre una componente (acerca de la funcionalidad específica de una instancia de una componente). JComponent tiene incorporado el soporte para brindar información de accesibilidad. Todas las componentes Swing tienen la capacidad de obtener su información de accesibilidad.... JTextField untexto = new JTextField(); AccesibleContext uncontextodetexto = untexto.getaccesiblecontext(); uncontextodetexto.setaccesiblename( Apellido ); uncontextodetexto.setaccesibledescription( Tipee su Apellido );

23 Tooltips Los tooltips son una línea de texto que se despliegan en una ventana cuando el cursor permanece apoyado sobre una componente por un período de tiempo específico. Ese tiempo se llama retardo inicial y el valor por defecto es 750 milisegundos. Un tooltip se asocia a una componente invocando el método settooltiptext(string) de la clase JComponent. El parámetro string representa el texto que será desplegado en la ventana del tooltip. Los tooltips no soportan múltiples líneas de texto. Las reglas de buen diseño de GUI establecen que los tooltips tienen que ser cortos y precisos. Los tooltips finalizan debido a: a) el curso abandona la componente, b) se presiona el mouse ó c) expira el retardo final (4 segundos). Cuando el cursor deja una componente que mostraba un tooltip, comienza a funcionar otro retardo (0.5 seg.). Si el cursor entra a otra componente equipada con un tooltip, este se muestra inmediatamente. Es posible personalizar los tooltips fijando los valores de estos tiempos invocando métodos de clase de la clase ToolTipManager.

24 Tooltips import java.awt.*; import javax.swing.*; public class ToolTipTest extends JApplet { public void init() { Container contentpane=getcontentpane(); JButton botoncito = new JButton( Tengo un tooltip ); botoncito.settooltiptext( Soy un Botoncito"); contentpane().setlayout(new FlowLayout()); contentpane().add(botoncito); } } La clase JComponent provee múltiples opciones para setear tooltips y para personalizar su comportamiento, como por ejemplo establecer la posición del tooltip (de acuerdo a la posición es el texto que se muestra).

25 Debug graphic El debug graphic permite a los programadores entender exactamente cómo las componentes se dibujan sobre la pantalla. Esto es especialmente útil cuando se implementan componentes de UI customizadas. Swing provee la clase javax.swing.debuggraphics, subclase de java.awt.graphics que disminuye la velocidad con que las operaciones gráficas son realizadas. Invocando métodos de clase de la clase DebugGraphics, es posible establecer el número de flashes por operación, el color del flash, etc. Invocando al método setdebuggraphicsoptions(int) de JComponent es posible obtener información de debug, como por ejemplo que se abra una ventana que muestre el buffer offscreen de una componente double buffer. El argumento int indica la opción de debug.

26 Autoscrolling JComponent soporta autoscrolling. De esta manera, las componentes tienen la capacidad de rolar cuando el mouse es arrastrado afuera de las cotas de la componente. El autoscrolling se activa y desactiva invocando al método setautoscrolls(boolean) de la clase JComponent. Además es posible consultar el estado del autoscrolling de una componente mediante el método getautoscrolls(). Por default, el autoscrolling está habilitado solamente para listas y tablas. Por ejemplo, si tenemos una componente JLIST de seis elementos y se fijan como visibles solamente tres, entonces como por defecto está habilitado el scrooling en listas, la lista se mostrará en un srollpane. Implementar el autoscrolling en una componente customizada requiere que la componente maneje el evento mouse dragged (especificado por la interfaz MouseMotionListener) que ocurre afuera de las cotas de la componente.

27 Manejo de abreviaturas La clase JComponent provee una facilidad para manejo de abreviaturas. De ésta forma, se evita a los programadores que filtren las abreviaturas. Las componentes Swing pueden disparar eventos y delegar su manejo a un listener específico cuando una abreviatura es tipeada. El método registerkeyboardaction(actionlistener, KeyStroke, int) de la clase JComponent registra una abreviatura sobre la componente. Cuando la abreviatura es tipeada, el método actionperformed() es invocado si la condición dada por el parámtero int se cumple (por ej. cuando la componente tiene el focus); el método getregisteredkeystrokes() devuelve todas las abreviaturas asociadas a una componente. Las condiciones bajo las cuales son manejadas las abreviaturas se especifican mediante constantes enteras de la clase JComponent: WHEN_FOCUSED WHEN_ANCESTOR_OF_FOCUSED_COMPONENT WHEN_IN_FOCUSED_WINDOWS