Sidar, principal.
>>contenido
Fundación Sidar - Acceso Universal
Seminario SIDAR
Principal >> Aplicación: UAW >> Documentación de las clases java

uaw
Class Caixa

java.lang.Object
  |
  +--com.steadystate.css.dom.CSSStyleRuleImpl
        |
        +--uaw.Caixa
All Implemented Interfaces:
org.w3c.dom.css.CSSRule, org.w3c.dom.css.CSSStyleRule, java.io.Serializable

public class Caixa
extends com.steadystate.css.dom.CSSStyleRuleImpl
implements org.w3c.dom.css.CSSStyleRule

Caixa representa una regla CSS que da información bàsica de posicionamento según el modelo de las cajas.

Una regla CSS es un conjunto de propietades de estilo CSS asignadas a un selector, como por ejemplo:

.encabezado{position:absolute;
top:0.5em;
left: 2em;
border-width: 0.2 em;
border-style: solid;}

en la que encabezado es el selector, position, top, etc. son las propiedades CSS y absolute, 0.5em, etc son los valores de estas propiedades.

Además de las propiedades CSS, Caixa guarda el nombre del selector -- que siempre empezará por'.' --, el nombre de la Caixa contenedora (padre) y un tipo para indicar si es de OBERTURA(apertura), CONTINGUT(contenido) o TANCAMENT(cierre).

En el paquete uaw el uso de esta clase está muy vinculado a la clase EstructuraDivisions que guarda información de todas las cajas de una página web y de su interrelación.

Las reglas CSS se aplican usualmente al contenido de una página XHTML mediante el elemento div que engloba una parte del código XHTML. Cada una de estas partes se suele conocer como "división" de la página

Un ejemplo sería el siguiente trozo de texto XHTML:

<body>
...
  • <div class="encabezado">
    • <h1>Mi título</h1>
    • <p> Este web trata sobre bla, bla, bla... </p>
  • </div>
...

Nota a los programadores

Esta clase se basa en la implementación de Steadystate del API css.dom del W3C, en la que por el momento no se controla la corrección de los valores asignados a las diferentes propiedades CSS

Version:
1.0, 2004/06
Author:
Mireia Ribera
See Also:
uaw.EstructuraDivisions , www.w3.org/TR/CSS2, Serialized Form

UML data model
legend graphical representation



Field Summary
protected java.lang.String caixaPare
Nombre de la Caixa contenedora.
protected static int comptadorCaixes
Contador para generar nombres de cajas correlativos de forma automática.
static int CONTINGUT
CONTINGUT es un posible valor de tipo.
static java.lang.String nomCaixes
static int OBERTURA
OBERTURA es un posible valor de tipo.
static int TANCAMENT
TANCAMENT es un posible valor de tipo.
protected int tipus
Tipo de Caixa: OBERTURA, CONTINGUT o TANCAMENT.
private java.lang.String valorParsejat
valorParsejat es un camp comodín que sirve para guardar una cadena qualquiera desde la lectura del fichero original XHTML, y que no sufre ninguna alteración.
Fields inherited from class com.steadystate.css.dom.CSSStyleRuleImpl
Fields inherited from interface org.w3c.dom.css.CSSRule
CHARSET_RULE, FONT_FACE_RULE, IMPORT_RULE, MEDIA_RULE, PAGE_RULE, STYLE_RULE, UNKNOWN_RULE
Constructor Summary
Caixa ()
Crea una nueva nueva Caixa sin ninguna propiedad CSS, con el campo tipus inicializado a CONTINGUT y el campo c aixaPare inicializado a '_top'
Method Summary
java.lang.Object clone ()
static Caixa crearCaixaTancament (java.lang.String nom)
Crea una Caixa de tipo TANCAMENT de nombre nom.
boolean esContingut ()
Indica si la Caixa es de tipo CONTINGUT
boolean esObertura ()
Indica si la Caixa es de tipo OBERTURA
boolean esTancament ()
Indica si la Caixa es de tipo TANCAMENT
java.lang.String getCaixaPare ()
Devuelve el nombre de la Caixa contenedora
java.lang.String getNom ()
Recupera el nombre del selector CSS sin el '.'
java.lang.String getValorParsejat ()
Devuelve un valor que se ha decidido guardar desde la lectura del fichero original XHTML, y que no ha sufrido ninguna alteración.
void mostrar (java.io.PrintStream sortida)
Presenta los valores de las propiedades dadas y del selector según la sintaxis CSS i los muestra por el canal de salida especificado en las cajas de tipo CONTINGUT y OBERTURA.
protected void reset ()
Inicializa el tipo a CONTINGUT y caixaPare a _top
void setBorder (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS border.
void setBorderWidth (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad border-width.
void setBottom (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS bottom.
void setCaixaPare (java.lang.String nom)
Asigna un nombre a la Caixa contenedora
void setHeight (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS height.
void setLeft (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS left.
void setMargin (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS margin.
void setMarginBottom (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS margin-bottom.
void setMarginLeft (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS margin-left.
void setMarginRight (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS margin-right.
void setMarginTop (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS margin-top.
void setNom ()
Asigna un nombre al selector CSS de forma automática según el modelo 'CaixaX' , en el que X es un número correlativo.
void setNom (java.lang.String nom)
Asigna un nombre al selector CSS según el parámetro.
void setOverflow (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS overflow.
void setPosition (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS position.
void setRight (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS right.
void setTipus (int tipus)
Asigna el valor del parámetro al campo tipus.
void setTipusContingut ()
Asigna el valor CONTINGUT al campo tipus.
void setTipusObertura ()
Asigna el valor OBERTURA al campo tipus.
void setTipusTancament ()
Asigna el valor TANCAMENT al campo tipus.
void setTop (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS top.
void setValorParsejat (java.lang.String valor)
Asigna el valor valor al campo valorParsejat.
void setWidth (java.lang.String valor)
Asigna el valor del parámetro valor a la propiedad CSS width.
Methods inherited from class com.steadystate.css.dom.CSSStyleRuleImpl
getCssText, getParentRule, getParentStyleSheet, getSelectorText, getStyle, getType, setCssText, setSelectorText, setStyle, toString
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.w3c.dom.css.CSSStyleRule
getSelectorText, getStyle, setSelectorText
Methods inherited from interface org.w3c.dom.css.CSSRule
getCssText, getParentRule, getParentStyleSheet, getType, setCssText

Field Detail

comptadorCaixes

protected static int comptadorCaixes

Contador para generar nombres de cajas correlativos de forma automática.

See Also:
setNom()

CONTINGUT

public static final int CONTINGUT

CONTINGUT es un posible valor de tipus.

Las cajas de contenido estan previstas para un funcionamiento autónomo o como elementos formantes de una EstructuraDivisions; en este último caso no pueden contener ninguna división creada por el programa.

See Also:
uaw.EstructuraDivisions , Constant Field Values

nomCaixes

public static final java.lang.String nomCaixes
See Also:
Constant Field Values

OBERTURA

public static final int OBERTURA

OBERTURA es un posible valor de tipus.

Las cajas de apertura estan previstas para ser usadas únicamente como elementos formantes de una EstructuraDivisions; en la EstructuraDivisions marcan el inicio de una división.

See Also:
uaw.EstructuraDivisions , Constant Field Values

TANCAMENT

public static final int TANCAMENT

TANCAMENT es un posible valor de tipus.

Les cajas de cierre estan previstas únicamente para ser usadas como elementos formantes de una EstructuraDivisions; y en la EstructuraDivisions marcan el final de una división. Deben tener el mismo nombre que la Caixa de apertura correspondiente, y no pueden tener valores en las propiedades CSS.

See Also:
uaw.EstructuraDivisions , Constant Field Values

caixaPare

protected java.lang.String caixaPare

Nombre de la Caixa contenedora. En caso de no haberse definido su valor es '_top'.


tipus

protected int tipus

Tipo de Caixa: OBERTURA, CONTINGUT o TANCAMENT.

Si se usan las cajas de forma aislada se recomienda usar sólo cajas de contenido; ahora bien, si las cajas se usan dentro de una EstucturaDivisions de una página XHTML, se usarán las cajas de apertura para marcar el inicio de una división, las cajas de cierra para marcar el final, y las cajas de contenido se reservarn para el contenido própiamente dicho, sin poder contener ninguna división creada por el programa en su interior.

See Also:
uaw.EstructuraDivisions

valorParsejat

private java.lang.String valorParsejat

valorParsejat es un campo comodin que sierve para guardar una cadena cualquiera desde la lectura del fichero original XHTML, y que no sufre ninguna alternación.

Constructor Detail

Caixa

public Caixa()

Crea una nueva Caixa sin ninguna propiedad CSS, con el campo ipus inicializado a CONTINGUT y el campo caixaPare inicializado a '_top'

Method Detail

crearCaixaTancament

public static Caixa crearCaixaTancament(java.lang.String nom)
                                 throws UawException

Crea una Caixa de tipo TANCAMENT de nombre nom.

Estas cajas se usan para delimitar el ámbito de las cajas apretura en la EstructuraDivisions y tienen todas las propiedades CSS sin valor.

Parameters:
nom - el nombre del selector CSS
Throws:
UawException - si el nombre dado no se corresponde al léxico CSS: letras, números o '_' .
See Also:
uaw.EstructuraDivisions

clone

public java.lang.Object clone()
Overrides:
clone in class java.lang.Object

esContingut

public boolean esContingut()

Indica si la Caixa es de tipo CONTINGUT


esObertura

public boolean esObertura()

Indica si la Caixa es de tipo OBERTURA


esTancament

public boolean esTancament()

Indica si la Caixa es de tipo TANCAMENT


getCaixaPare

public java.lang.String getCaixaPare()

Devuelve el nombre de la Caixa contenedora


getNom

public java.lang.String getNom()

Recupera el nombre del selector CSS sin el '.'


getValorParsejat

public java.lang.String getValorParsejat()

Devuelve un valor que se ha decidido guardar desde la lectura del fichero original XHTML, y que no ha sufrido ninguna transformación.


mostrar

public void mostrar(java.io.PrintStream sortida)

Presenta los valores de las propiedades dadas y del selector según la sintaxis CSS y los muestra por el canal de salida especificado en las cajas de tipo CONTINGUT y OBERTURA. Las cajas de tipo TANCAMENT no se muestran.

Parameters:
sortida - canal de salida por donde mostrar los campos

reset

protected void reset()

Inicializa tipus a CONTINGUT y caixaPare a _top


setBorder

public void setBorder(java.lang.String valor)
               throws java.lang.NullPointerException,
                      java.lang.IllegalArgumentException,
                      UawException

Asigna el valor del parámetro valor a la propiedad CSS border.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setBorderWidth

public void setBorderWidth(java.lang.String valor)
                    throws java.lang.NullPointerException,
                           java.lang.IllegalArgumentException,
                           UawException

Asigna el valor del parámetro valor a la propiedad CSS border-width.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setBottom

public void setBottom(java.lang.String valor)
               throws java.lang.NullPointerException,
                      java.lang.IllegalArgumentException,
                      UawException

Asigna el valor del parámetro valor a la propiedad CSS bottom.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setCaixaPare

public void setCaixaPare(java.lang.String nom)
                  throws java.lang.NullPointerException,
                         java.lang.IllegalArgumentException

Assigna un nom a la Caixa contenidora

Throws:
java.lang.NullPointerException - si el nom donat és nul
java.lang.IllegalArgumentException - si el nom donat no s'adiu al lèxic CSS: lletres, números o '_' .

setHeight

public void setHeight(java.lang.String valor)
               throws java.lang.NullPointerException,
                      java.lang.IllegalArgumentException,
                      UawException

Asigna el valor del parámetro valor a la propiedad CSS height.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setLeft

public void setLeft(java.lang.String valor)
             throws java.lang.NullPointerException,
                    java.lang.IllegalArgumentException,
                    UawException

Asigna el valor del parámetro valor a la propiedad CSS left.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setMargin

public void setMargin(java.lang.String valor)
               throws java.lang.NullPointerException,
                      java.lang.IllegalArgumentException,
                      UawException

Asigna el valor del parámetro valor a la propiedad CSS margin.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setMarginBottom

public void setMarginBottom(java.lang.String valor)
                     throws java.lang.NullPointerException,
                            java.lang.IllegalArgumentException,
                            UawException

Asigna el valor del parámetro valor a la propiedad CSS margin-bottom.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setMarginLeft

public void setMarginLeft(java.lang.String valor)
                   throws java.lang.NullPointerException,
                          java.lang.IllegalArgumentException,
                          UawException

Asigna el valor del parámetro valor a la propiedad CSS margin-left.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setMarginRight

public void setMarginRight(java.lang.String valor)
                    throws java.lang.NullPointerException,
                           java.lang.IllegalArgumentException,
                           UawException

Asigna el valor del parámetro valor a la propiedad CSS margin-right.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setMarginTop

public void setMarginTop(java.lang.String valor)
                  throws java.lang.NullPointerException,
                         java.lang.IllegalArgumentException,
                         UawException

Asigna el valor del parámetro valor a la propiedad CSS margin-top.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setNom

public void setNom()
            throws org.w3c.dom.DOMException,
                   UawException

Asigna un nombre al selector CSS de forma automática según el modelo 'CaixaX' donde X es un número correlativo.

Throws:
UawException - si el nombre dado no pertenece al léxico CSS: letras, números o '_' .
org.w3c.dom.DOMException - si hay algún problema en la asignación del nombre

setNom

public void setNom(java.lang.String nom)
            throws java.lang.NullPointerException,
                   java.lang.IllegalArgumentException,
                   UawException

Asigna un nombre al selector CSS según el parámetro. Esta clase construye selectores de atributo de tipo class, es decir, que en su definición se prefijarán por '.' y se aplicarán mediante el atributo 'class'.

Parameters:
nom - el nombre del selector CSS a asignar a la Caixa.
Throws:
java.lang.IllegalArgumentException - si el nombre dado no pertenece al léxico CSS: letras, números o '_' .
UawException - si hay algún problema en la asignación del nombre
java.lang.NullPointerException

setOverflow

public void setOverflow(java.lang.String valor)
                 throws java.lang.NullPointerException,
                        java.lang.IllegalArgumentException,
                        UawException

Asigna el valor del parámetro valor a la propiedad CSS overflow.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setPosition

public void setPosition(java.lang.String valor)
                 throws java.lang.NullPointerException,
                        java.lang.IllegalArgumentException,
                        UawException

Asigna el valor del parámetro valor a la propiedad CSS position.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setRight

public void setRight(java.lang.String valor)
              throws java.lang.NullPointerException,
                     java.lang.IllegalArgumentException,
                     UawException

Asigna el valor del parámetro valor a la propiedad CSS right.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setTipus

public void setTipus(int tipus)
              throws java.lang.IllegalArgumentException

Asigna el valor del parámetro al campo tipus. El valor hay que darlo según las constantes OBERTURA, TANCAMENT o CONTINGUT.

Atención!! Si el tipo es TANCAMENT este método borra todos los valores de las propiedades CSS

Parameters:
tipus - el valor a asignar
Throws:
java.lang.IllegalArgumentException - si tipus no es correcto.

setTipusContingut

public void setTipusContingut()

Asigna el valor CONTINGUT al campo tipus.


setTipusObertura

public void setTipusObertura()

Asigna el valor OBERTURA al campo tipus.


setTipusTancament

public void setTipusTancament()

Asigna el valor TANCAMENT al campo tipus.

Atención!! Este método borra todos los valores de las propiedades CSS.


setTop

public void setTop(java.lang.String valor)
            throws java.lang.NullPointerException,
                   java.lang.IllegalArgumentException,
                   UawException

Asigna el valor del parámetro valor a la propiedad CSS top.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String valor,String priority)

setValorParsejat

public void setValorParsejat(java.lang.String valor)
                      throws java.lang.NullPointerException,
                             UawException

Asigna el valor valor al campo valorParsejat.

Parameters:
valor - el valor a asignar
Throws:
java.lang.NullPointerException - si valor es nulo
UawException - si Caixa actual es del tipo TANCAMENT.

setWidth

public void setWidth(java.lang.String valor)
              throws java.lang.NullPointerException,
                     java.lang.IllegalArgumentException,
                     UawException

Asigna el valor del parámetro valor a la propiedad CSS width.

Parameters:
valor - es una cadena que contiene el valor de la propiedad y las unidades en sintaxis CSS
Throws:
java.lang.NullPointerException - si valor es nulo
java.lang.IllegalArgumentException - si Caixa actual es del tipo TANCAMENT.
UawException - si se ha producido algún problema al establecer la propiedad CSS
See Also:
org.w3c.dom.css.CSSStyleDeclaration.setProperty(String propertyName,String value,String priority)