pt.despodata.java.ddata
Class DHtmlVisualField

java.lang.Object
  pt.despodata.java.ddata.DHtmlVisualField

All Implemented Interfaces:

IDDataVisualField

public class DHtmlVisualField

extends java.lang.Object

implements IDDataVisualField

DHtmlVisualField.java Informacoes acerca de um campo de uma tabela que e visualizavel Created: Tue Aug 29 10:38:54 2000

Version:

$Revision: 1.3 $

Author:

Paulo Carmo

Field Summary

static java.util.Comparator	integerVectorComparator Comparador para ordenar Vectores de Inteiros por ordem alfabetica do primeiro inteiro do Vector.
static java.util.Comparator	stringVectorComparator Comparador para ordenar Vectores de Strings por ordem alfabetica da primeira string do Vector.

Fields inherited from interface pt.despodata.java.ddata.IDDataVisualField

COMBOBOX_FIELD, FILEUPLOAD_FIELD, HIDDEN_FIELD, IMAGE_FIELD, LOV_FIELD, PASSWORD_FIELD, RADIO_FIELD, RESET_FIELD, SELECT_FIELD, SUBMIT_FIELD, TEXT_FIELD, TEXTAREA_FIELD

Constructor Summary

DHtmlVisualField(java.lang.String name, int width, int height, int fieldType)

DHtmlVisualField(java.lang.String name, int width, int height, int visibleWidth, int visibleHeight, int fieldType, int fieldFontSize)

Method Summary

void	addDescription(java.lang.String code, java.lang.Object description) Adiciona uma descricao a lista de descricoes.
void	addReferencedColumn(java.lang.String comboboxTableName, java.lang.String comboDescriptionColumn, java.lang.String comboCodeColumn) Associa uma coluna de descricao ao campo visual.
void	clearDescriptions() Apaga todas as descricoes deste campo visual.
void	dump() Imprime o conteudo do objecto (para debug apenas)
void	dump(java.lang.String _prefix) Imprime o conteudo do objecto (para debug apenas)
boolean	equals(java.lang.Object obj) Indicates whether some other object is "equal to" this one.
java.lang.Object	getCode(java.util.Vector descriptions) Devolve o primeiro codigo encontrado que se encontra associado a uma lista de descricoes.
java.util.Enumeration	getCodesList() Devolve uma lista com os codigos da lista de descricoes.
int	getDecimals() Devolve o numero de casas decimais que se permite digitar.
java.util.Vector	getDescriptions(java.lang.Object code) Devolve as descricoes de um campo visual para um determinado codigo.
java.util.Enumeration	getDescriptionsList() Devolve uma lista com todas as descricoes associadas ao campo visual.
java.util.Comparator	getDescriptionsListComparator() Getter for property _descriptionsListComparator.
java.lang.String	getFieldFontName() Devolve o nome da fonte usada no campo visual.
int	getFieldFontSize() Get the value of fontSize.
int	getFieldType() Get the value of fieldType.
java.lang.String	getFieldTypeName() Devolve o nome de um tipo de campo, dado o seu codigo.
int	getHeight() Devolve a altura do campo.
java.lang.String	getName() Devolve o nome do campo.
DDataControl	getReferencedDataControl(DDataSource dataSource, java.lang.String whereStr) Devolve o DHtmlDataControl que representa a tabela que contem a descricao deste campo visual
java.lang.String	getReferencedTable() Get the value of comboboxTable.
java.lang.String[]	getRefField() Devolve o nome do campo visual que contem o codigo deste campo visual.
java.lang.String	getRefWhereStr() Get the value of refWhereStr.
int	getVisibleHeight() Devolve a altura do campo que e visivel.
int	getVisibleWidth() Devolve o comprimento do campo que e visivel.
int	getWidth() Devolve o comprimento do campo.
boolean	isAutoFormat() Verifica se a formatacao e automatica.
boolean	isEditable() Verifica se o campo pode ser editado.
boolean	isReference() Verifica se um campo visual pertence ao DHtmlDataControl, ou se e uma campo que faz referencia para outra tabela.
boolean	isRequired() Verifica se um campo e de preenchimento obrigatorio.
DDataControl	loadReferencedTable(DDataSource dataSource) Le as descricoes e os codigos, da tabela de referencia e coloca as descricoes e os codigos na Hashtable 'listOfDescr'
DDataControl	refreshReferencedTable(DDataSource dataSource) Le as descricoes e os codigos, da tabela de referencia e coloca as descricoes e os codigos na Hashtable 'listOfDescr' A tabela e relida da base de dados, mesmo que ja se encontre em memoria.
void	rmDescription(java.lang.String code) Remove uma descricao da lista de valores.
void	rmReferencedColumn(java.lang.String descriptionColumn) Remove uma chave estrangeira.
void	setAutoFormat(boolean auto) Activa ou desactiva a formatacao automatica.
void	setDecimals(int decimals) Define o numero de casas decimais que se permite digitar.
void	setDescriptionsListComparator(java.util.Comparator descriptionsListComparator) Setter for property _descriptionsListComparator.
void	setEditable(boolean editable) Torna o campo editavel ou nao
void	setFieldFontSize(int v) Set the value of fontSize.
void	setFieldType(int v) Set the value of fieldType.
void	setHeight(int height) Afecta a altura do campo.
void	setInvisibleDescColumns(java.lang.String[] value) Setter for property _inVisibleDescColumns.
void	setName(java.lang.String name) Altera o nome do campo.
void	setOrderBy(java.lang.String[] orderBy) Setter for property orderBy.
void	setReferencedTable(java.lang.String v) Set the value of comboboxTable.
void	setRefField(java.lang.String columnName, java.lang.String vfName) Altera a identificacao do campo visual que contem o codigo deste campo visual.
void	setRefWhereStr(java.lang.String v) Set the value of refWhereStr.
void	setRequired(boolean required) Activa ou desactiva a obrigatoridade do campo.
void	setVisibleHeight(int height) Afecta a altura do campo que e visivel.
void	setVisibleWidth(int width) Afecta o comprimento do campo que e visivel.
void	setWidth(int width) Afecta o comprimento do campo.
java.lang.String	toString() Devolve o conteudo do objecto (para debug apenas)
java.lang.String	toString(java.lang.String _prefix) Devolve o conteudo do objecto (para debug apenas)

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

integerVectorComparator

public static java.util.Comparator integerVectorComparator

Comparador para ordenar Vectores de Inteiros por ordem alfabetica do primeiro inteiro do Vector.

stringVectorComparator

public static java.util.Comparator stringVectorComparator

Comparador para ordenar Vectores de Strings por ordem alfabetica da primeira string do Vector.

Constructor Detail

DHtmlVisualField

public DHtmlVisualField(java.lang.String name,
                        int width,
                        int height,
                        int fieldType)

DHtmlVisualField

public DHtmlVisualField(java.lang.String name,
                        int width,
                        int height,
                        int visibleWidth,
                        int visibleHeight,
                        int fieldType,
                        int fieldFontSize)

Method Detail

equals

public boolean equals(java.lang.Object obj)

Indicates whether some other object is "equal to" this one.

Parameters:

obj - - the reference object with which to compare.

Returns:

true if this object is the same as the obj argument; false otherwise

addDescription

public void addDescription(java.lang.String code,
                           java.lang.Object description)

Adiciona uma descricao a lista de descricoes.

Specified by:

addDescription in interface IDDataVisualField

Parameters:

code - Codigo associado a descricao.

description - Nome que aparece na lista.

addReferencedColumn

public void addReferencedColumn(java.lang.String comboboxTableName,
                                java.lang.String comboDescriptionColumn,
                                java.lang.String comboCodeColumn)

Associa uma coluna de descricao ao campo visual. Este metodo pode ser chamado varias vezes para se adicionara varias colunas de descricao ao campo visual. A ordem pela qual sao adicionados as colunas e mantida.

Specified by:

addReferencedColumn in interface IDDataVisualField

Parameters:

comboboxTableName - Nome da tabela que contem as descricao e os codigos para popular a combobox.

comboDescriptionColumn - Nome da coluna que contem a descricao na tabela 'comboboxTableName'.

comboCodeColumn - Nome da coluna que contem o codigo na tabela 'comboboxTableName'.

clearDescriptions

public void clearDescriptions()

Apaga todas as descricoes deste campo visual.

Specified by:

clearDescriptions in interface IDDataVisualField

getCode

public java.lang.Object getCode(java.util.Vector descriptions)

Devolve o primeiro codigo encontrado que se encontra associado a uma lista de descricoes. Pode existir mais codigos associados a mesma descricao.

Specified by:

getCode in interface IDDataVisualField

Parameters:

descriptions - A lista de descricoes.

Returns:

O codigo que se encontra associado a descricao.

getCodesList

public java.util.Enumeration getCodesList()

Devolve uma lista com os codigos da lista de descricoes.

Specified by:

getCodesList in interface IDDataVisualField

Returns:

Uma lista com os codigos da lista de descricoes.

getDecimals

public int getDecimals()

Devolve o numero de casas decimais que se permite digitar.

Specified by:

getDecimals in interface IDDataVisualField

Returns:

O numero de casas decimais que se permite digitar.

getDescriptions

public java.util.Vector getDescriptions(java.lang.Object code)

Devolve as descricoes de um campo visual para um determinado codigo.

Specified by:

getDescriptions in interface IDDataVisualField

Parameters:

code - Codigo da descricao pretendida.

Returns:

Uma Lista de descricoes de um campo visual para um determinado codigo ordenada.

getDescriptionsList

public java.util.Enumeration getDescriptionsList()

Devolve uma lista com todas as descricoes associadas ao campo visual. Cada elemento da lista e um Vector, que contem uma descricao para um determinado codigo deste campo visual. Este Vector contem tantos elementos quanto o numero de colunas de descricao que foram adicionadas ao campo visual atraves do metodo pt.despodata.java.ddata.DHtmlVisualField#addReferencedColumnjava.lang.String, java.lang.String, java.lang.String) addReferencedColumn. A lista encontra-se ordenada por ordem alfabetica.

Specified by:

getDescriptionsList in interface IDDataVisualField

Returns:

Uma lista de nomes ordenada por ordem alfabetica.

getFieldType

public int getFieldType()

Get the value of fieldType.

Specified by:

getFieldType in interface IDDataVisualField

Returns:

Value of fieldType.

getFieldTypeName

public java.lang.String getFieldTypeName()

Devolve o nome de um tipo de campo, dado o seu codigo.

Specified by:

getFieldTypeName in interface IDDataVisualField

Returns:

O nome do tipo do campo.

getFieldFontName

public java.lang.String getFieldFontName()

Devolve o nome da fonte usada no campo visual.

Specified by:

getFieldFontName in interface IDDataVisualField

Returns:

O nome da fonte usada no campo visual.

getFieldFontSize

public int getFieldFontSize()

Get the value of fontSize.

Specified by:

getFieldFontSize in interface IDDataVisualField

Returns:

Value of fontSize.

getHeight

public int getHeight()

Devolve a altura do campo.

Specified by:

getHeight in interface IDDataVisualField

Returns:

A altura do campo.

getName

public java.lang.String getName()

Devolve o nome do campo.

Specified by:

getName in interface IDDataVisualField

Returns:

O nome do campo.

getRefWhereStr

public java.lang.String getRefWhereStr()

Get the value of refWhereStr.

Specified by:

getRefWhereStr in interface IDDataVisualField

Returns:

Value of refWhereStr.

getReferencedDataControl

public DDataControl getReferencedDataControl(DDataSource dataSource,
                                             java.lang.String whereStr)

Devolve o DHtmlDataControl que representa a tabela que contem a descricao deste campo visual

Specified by:

getReferencedDataControl in interface IDDataVisualField

Parameters:

dataSource - DDataSource, onde se encontra a tabela.

Returns:

O DHtmlDataControl que representa a tabela que contem a descricao deste campo visual

getReferencedTable

public java.lang.String getReferencedTable()

Get the value of comboboxTable.

Specified by:

getReferencedTable in interface IDDataVisualField

Returns:

Value of comboboxTable.

getVisibleHeight

public int getVisibleHeight()

Devolve a altura do campo que e visivel.

Specified by:

getVisibleHeight in interface IDDataVisualField

Returns:

A altura do campo que e visivel.

getVisibleWidth

public int getVisibleWidth()

Devolve o comprimento do campo que e visivel.

Specified by:

getVisibleWidth in interface IDDataVisualField

Returns:

O comprimento do campo que e visivel.

getWidth

public int getWidth()

Devolve o comprimento do campo.

Specified by:

getWidth in interface IDDataVisualField

Returns:

O comprimento do campo.

isAutoFormat

public boolean isAutoFormat()

Verifica se a formatacao e automatica.

Specified by:

isAutoFormat in interface IDDataVisualField

Returns:

true se a formatação for automática, false caso contrario.

isEditable

public boolean isEditable()

Verifica se o campo pode ser editado.

Specified by:

isEditable in interface IDDataVisualField

Returns:

true se o campo fôr editável, false caso contrário.

isReference

public boolean isReference()

Verifica se um campo visual pertence ao DHtmlDataControl, ou se e uma campo que faz referencia para outra tabela.

Specified by:

isReference in interface IDDataVisualField

Returns:

true caso o campo visual seja uma referencia para uma coluna de outra tabela, false caso contrario.

isRequired

public boolean isRequired()

Verifica se um campo e de preenchimento obrigatorio.

Specified by:

isRequired in interface IDDataVisualField

Returns:

true caso o campo seja de preenchimento obrigatorio, false caso contrario.

loadReferencedTable

public DDataControl loadReferencedTable(DDataSource dataSource)

Le as descricoes e os codigos, da tabela de referencia e coloca as descricoes e os codigos na Hashtable 'listOfDescr'

Specified by:

loadReferencedTable in interface IDDataVisualField

Parameters:

dataSource - DDataSource, onde se encontra a tabela.

refreshReferencedTable

public DDataControl refreshReferencedTable(DDataSource dataSource)

Le as descricoes e os codigos, da tabela de referencia e coloca as descricoes e os codigos na Hashtable 'listOfDescr' A tabela e relida da base de dados, mesmo que ja se encontre em memoria.

Specified by:

refreshReferencedTable in interface IDDataVisualField

Parameters:

dataSource - DDataSource, onde se encontra a tabela.

rmDescription

public void rmDescription(java.lang.String code)

Remove uma descricao da lista de valores.

Specified by:

rmDescription in interface IDDataVisualField

Parameters:

code - Codigo da descricao que se pretende remover.

rmReferencedColumn

public void rmReferencedColumn(java.lang.String descriptionColumn)

Remove uma chave estrangeira.

Specified by:

rmReferencedColumn in interface IDDataVisualField

Parameters:

descriptionColumn - Nome da coluna que contem a descricao.

setFieldFontSize

public void setFieldFontSize(int v)

Set the value of fontSize.

Specified by:

setFieldFontSize in interface IDDataVisualField

Parameters:

v - Value to assign to fontSize.

setAutoFormat

public void setAutoFormat(boolean auto)

Activa ou desactiva a formatacao automatica.

Specified by:

setAutoFormat in interface IDDataVisualField

Parameters:

auto - true para que exista formatação automática, false não faz qualquer formatação

setDecimals

public void setDecimals(int decimals)

Define o numero de casas decimais que se permite digitar.

Specified by:

setDecimals in interface IDDataVisualField

Parameters:

decimals - Número de casas decimais que se permite digitar.

setEditable

public void setEditable(boolean editable)

Torna o campo editavel ou nao

Specified by:

setEditable in interface IDDataVisualField

Parameters:

editable - true se o campo fôr editável, false caso contrário

setFieldType

public void setFieldType(int v)

Set the value of fieldType.

Specified by:

setFieldType in interface IDDataVisualField

Parameters:

v - Value to assign to fieldType.

setHeight

public void setHeight(int height)

Afecta a altura do campo.

Specified by:

setHeight in interface IDDataVisualField

Parameters:

height - Altura do campo.

setName

public void setName(java.lang.String name)

Altera o nome do campo.

Specified by:

setName in interface IDDataVisualField

Parameters:

name - O nome do campo.

setReferencedTable

public void setReferencedTable(java.lang.String v)

Set the value of comboboxTable.

Specified by:

setReferencedTable in interface IDDataVisualField

Parameters:

v - Value to assign to comboboxTable.

setRefWhereStr

public void setRefWhereStr(java.lang.String v)

Set the value of refWhereStr.

Specified by:

setRefWhereStr in interface IDDataVisualField

Parameters:

v - Value to assign to refWhereStr.

setRequired

public void setRequired(boolean required)

Activa ou desactiva a obrigatoridade do campo.

Specified by:

setRequired in interface IDDataVisualField

Parameters:

required - Se for true, o campo e de preenchimento obrigatorio, caso contrario, o campo nao e obrigatorio.

setWidth

public void setWidth(int width)

Afecta o comprimento do campo.

Specified by:

setWidth in interface IDDataVisualField

setVisibleHeight

public void setVisibleHeight(int height)

Afecta a altura do campo que e visivel.

Specified by:

setVisibleHeight in interface IDDataVisualField

Parameters:

height - Altura do campo que e visivel.

setVisibleWidth

public void setVisibleWidth(int width)

Afecta o comprimento do campo que e visivel.

Specified by:

setVisibleWidth in interface IDDataVisualField

setRefField

public void setRefField(java.lang.String columnName,
                        java.lang.String vfName)

Altera a identificacao do campo visual que contem o codigo deste campo visual.

Specified by:

setRefField in interface IDDataVisualField

getRefField

public java.lang.String[] getRefField()

Devolve o nome do campo visual que contem o codigo deste campo visual.

Specified by:

getRefField in interface IDDataVisualField

getDescriptionsListComparator

public java.util.Comparator getDescriptionsListComparator()

Getter for property _descriptionsListComparator.

Specified by:

getDescriptionsListComparator in interface IDDataVisualField

Returns:

Value of property _descriptionsListComparator.

setDescriptionsListComparator

public void setDescriptionsListComparator(java.util.Comparator descriptionsListComparator)

Setter for property _descriptionsListComparator.

Specified by:

setDescriptionsListComparator in interface IDDataVisualField

dump

public void dump()

Imprime o conteudo do objecto (para debug apenas)

Specified by:

dump in interface IDDataVisualField

dump

public void dump(java.lang.String _prefix)

Imprime o conteudo do objecto (para debug apenas)

Specified by:

dump in interface IDDataVisualField

toString

public java.lang.String toString()

Devolve o conteudo do objecto (para debug apenas)

toString

public java.lang.String toString(java.lang.String _prefix)

Devolve o conteudo do objecto (para debug apenas)

Specified by:

toString in interface IDDataVisualField

setOrderBy

public void setOrderBy(java.lang.String[] orderBy)

Setter for property orderBy.

Specified by:

setOrderBy in interface IDDataVisualField

Parameters:

orderBy - New value of property orderBy.

setInvisibleDescColumns

public void setInvisibleDescColumns(java.lang.String[] value)

Setter for property _inVisibleDescColumns.

Specified by:

setInvisibleDescColumns in interface IDDataVisualField