Las propiedades se fijan en los objetos Component y LayoutData para definir su apariencia visual y comportamiento.

Propiedades Mutables:  La mayoría de los objetos property (propiedad) son inmutables, esto es, no se pueden modificar una vez han sido instanciados.  Sin embargo algunos objetos property son demasiado complejos para ser definidos completamente en una sola llamada al constructor, y deben proporcionar configuración tras su instanciación.  Una vez que un property ha sido configurado, lo deberemos tratar siempre como si fuese inmutable.  La modificación del estado de un property que está siendo usado por una aplicación seguramente tendrá resultados no deseados.

Ahorro de Memoria:  Se puede mejorar el rendimiento almacenando las propiedades como constantes estáticas mejor que creándolas cada vez que se utilizan.  El uso de Styles (estilos) y StyleSheets (hojas de estilo) (tratados en un capitulo posterior de este tutorial) para almacenar propiedades tendrá como consecuencia los beneficios de un mayor ahorro de memoria.

Propiedades Comunes

Esta sección muestra algunos de los objetos property usados generalmente para configurar la apariencia visual de Componets Echo2.  Visita los enlaces a la documentación del API para obtener una visión mas completa de cada propiedad.

Alignment (alineación)

La propiedad Alignment se utiliza para describir cómo se deben alinear o posicionar los objetos entre ellos.  Esta propiedad se usa generalmente en implementaciones de LayoutData para controlar cómo se alinéan los Components hijos en el contenedor.  Los componentes Button y Label usan esta propiedad para describir cómo se debería posicionar y alinear el texto con respecto a un icono.

Se puede usar un solo objeto Aligmnent para representar tanto la alineación horizontal como la vertical.  Un valor de Aligment.DEFAULT  tanto para la porción vertical como la horizontal indica que un Aligment dado no afecta a cómo se debería manejar la alineación en dicho eje.

Limitaciones:  Algunos Components que usan objetos Aligment solamente pueden pintar la porción horizontal o vertical de la propiedad Alignment.  Otros Components obligarán a que una propiedad Aligment en particular tenga establecidos unos valores no-por-defecto en ambos valores vertical y horizontal.  Deberás dirigirte a la documentación del API para determinar las configuraciones correctas de los valores de las propiedades Aligment para un Component particular.

Referencia del API:  Visita la Documentación de Aligment del API para más información.

Border (borde)

El objeto de la propiedad Border describe un borde estilizado alrededor de una región.  Un borde puede tener un style (estilo), size (tamaño), y color específicos.  Están disponibles los siguientes estilos de borde:



Referencia del API: Visita la Documentación de Border del API para más información.

Color

El objeto de propiedad Color describe un color RGB.  Se pueden especificar colores arbitrarios construyendo un nuevo objeto Color con un valor RGB específico.  La misma clase Color proporciona varios colores comunes:



Referencia del API:  Visita la Documentación de Color del API para más información.

Extent (medida)

Un Extent describe una dimensión con unidades específicas.  Las Extents se usan extensivamente en los Components constituidos además de otras propiedades como Borders, Insets (márgenes interiores) y Fonts (fuentes de letra).

Extent.PX Pixels Extent.PERCENT Porcentaje (del tamaño del contenedor) Extent.PT Puntos (1/72 Pulgadas) Extent.IN Pulgadas Extent.PC Picas (1/6 Pulgadas) Extent.CM Centímetros Extent.MM Milímetros Extent.EX Exs Extent.EM Ems   
Requisitos de Unidades:  Algunas unidades no se puede usar en ciertos entornos.  Deberás dirigirte a la documentación del API para cada propiedad Extent de cada Component para determinar las unidades válidas.  Si no se hace correctamente se puede lanzar una excepción en tiempo de pintado.  Un número significante de Components necesitaran valores de Extent en pixels.

Referencia del API:  Visita la Documentación de Extent del API para más información.

FillImage (imagen de relleno)

Un FillImage describe cómo se rellenará una regisón con una imagen de fondo.  El uso de propiedades FillImage te pemiten personalizar la posición de una imagen de fondo así como su repetición.

Referencia del API:  Visita la Documentación de FillImage del API para más información.

Font (fuente de texto)

El objeto de propiedad Font describe el typeface (tipo), size (tamaño), y style (estilo) de un texto.  No es necesario especificar Fonts en cada Component: si un componente de texto no tiene un Font especificado, se dibujará usando el Font se su padre.

Referencia del API:  Visita la Documentación de Font del API para más información.

Insets (márgenes interiores)

Una propiedad Insets se usa para describir los márgenes interiores de una región.  Un objeto Insets contiene cuatro Extents, representando cada uno los márgenes top (superior), bottom (inferior), left (izquierdo), y right (derecho).

Referencia del API:  Visita la Documentación del Insets del API para más información.

ImageReferences (referencias a imagen)

Un ImageReference se usa para representar una imagen gráfica.  El objeto ImageReference en sí mismo es una interfaz, con cuatro implementaciones de varios métodos de recuperación de una imagen.

ResourceImageReference

Un ResourceImageReference representa una imagen que se puede recuperar usando un ClassLoader.  Generalmente el método más común de manejar imágenes en una aplicación Echo2 está en situarlas directamente en el CLASSPATH y acceder a ellas usando ResourceImageRefecences.

Referencia del API:  Visita la Documentación de ResourceImageReference del API para más información.

HttpImageReference

Una HttpImageReference represena una imagen que se puede obtener mediante una petición HTTP.  Usa HttpImageReferences en situaciones en las que tienes imágenes situadas en un servidor diferente al de la aplicación.  Para imágenes que se servirán por un servidor de aplicaciones basado en Java, HttpImageReferences no proporciona beneficio de rendimiento sobre ResourceImageReferences.

Referencia del API:  Visita la Documentación de HttpImageReference del API para más información.

StreamImageReference

StreamImageReference es una clase abstracta que permite que una aplicación proporcione una imagen para ser mostrada como un chorro de datos binarios.  Este tipo de imagen pudes ser util cuando las imágenes se obtienen de una base de datos o un sistema de archivos.

Referencia del API:  Visita la Documentación de StreamImageReference del API para más información.

AwtImageReference

AwtImageReferences proporciona la capacidad de pintar objetos java.awt.Image en clientes de aplicaciones Echo2.  La imagen será convertida a PNG antes de ser pintada.  El uso de AwtImagReferences necesitará que esté disponible un conexto gráfico, lo cual puede tener cierta dificultad en entornos Unix/Linux.  La solución típica para el tema del contexto gráfico es ejecutar la JVM anfitrión en modo headless.

Advertencia de Rendimiento:  Las AwtImageRenferences necesitarán una cantidad de memoria y ciclos de reloj significativos para pintarse.  La caida de rendimiento no se notará si se usan de modo poco frecuente.

Referencia del API:  Visita la Documentación de AwtImageReference del API para más información.