net.sf.jzeno.echo.databinding
Class DynaTextArea

java.lang.Object
  nextapp.echo.AbstractComponent
      net.sf.jzeno.echo.components.CustomComponent
          net.sf.jzeno.echo.databinding.DynaTextArea

All Implemented Interfaces:

java.beans.PropertyChangeListener, java.io.Serializable, java.util.EventListener, BindingTarget, PropertyComponent, RebindableComponent, EventSink, EventSource, Precreation, Component, FastComponent, FastComponentContainer

public final class DynaTextArea
extends CustomComponent
implements java.beans.PropertyChangeListener, FastComponent, Precreation

Shows a multi line text area on the screen. Bind this component to a string property.

See Also:

Serialized Form

Nested Class Summary

class

DynaTextArea.DefaultValidator

Field Summary

static int	CHARACTER_UNITS
static int	PERCENT_UNITS
static int	PIXEL_UNITS
static long	serialVersionUID

Fields inherited from interface nextapp.echo.Component

BACKGROUND_CHANGED_PROPERTY, CHILDREN_CHANGED_PROPERTY, ENABLED_CHANGED_PROPERTY, FONT_CHANGED_PROPERTY, FOREGROUND_CHANGED_PROPERTY, IDENTIFIER_CHANGED_PROPERTY, LOCALE_CHANGED_PROPERTY, MODEL_CHANGED_PROPERTY, SELECTABLE_CHANGED_PROPERTY, STYLE_BACKGROUND, STYLE_FONT, STYLE_FOREGROUND, UPDATE_PROPERTY, VISIBLE_CHANGED_PROPERTY

Constructor Summary

DynaTextArea()
Creates an unbound component.

DynaTextArea(java.lang.Class beanClass, java.lang.String propertyName, java.lang.String constructionHints)
Creates a bound component.

Method Summary

void	applyContext()
Color	getBackground() Gets the background color.
java.lang.String	getCssClass()
Font	getFont() Returns the font.
Color	getForeground() Gets the foreground (text) color.
int	getHeight() Gets the height of the text area.
int	getHeightUnits() Gets the units in which height is specified.
java.lang.String	getInvalidMessage() Gets the message key that is added to the screen, when the component is marked as invalid.
boolean	getLineWrap() Gets wether or not the text entered can be wrapped in the component.
int	getMaximumLength() Gets the maximum number of characters the user can enter in the input field.
java.lang.String	getNullValue() Gets the input value that corresponds to a data binding property value null.
java.lang.String	getText() Gets the text in the component.
java.lang.String	getToolTipText() Gets the tooltip that is shown when the user hoovers over this component.
int	getWidth() Gets the width of the text field.
int	getWidthUnits() Gets the units in which width is specified.
boolean	isAutoTrim() Gets whether or not this component trims the input from the user.
boolean	isConvertToLowerCase()
boolean	isConvertToUpperCase()
boolean	isReadOnly()
boolean	isRequired() Query if the editor is required to be filled in.
void	propertyChange(java.beans.PropertyChangeEvent evt) Used internally.
void	rebind() This operation causes the component to reset it's content to that of the domain model.
void	setAutoTrim(boolean autoTrim) Sets whether or not this component trims the input from the user.
void	setBackground(Color background) Sets the background color.
void	setColumns(int columns) Deprecated. use setWidth & setWidthUnits
void	setConvertToLowerCase(boolean convertToLowerCase)
void	setConvertToUpperCase(boolean convertToUpperCase)
void	setCssClass(java.lang.String newValue)
void	setFocused(boolean focused) Sets the input focus on this component.
void	setFont(Font font) Sets the font of the component.
void	setForeground(Color foreground) Sets the foreground (text) color.
void	setHeight(int width) Sets the height of the text area.
void	setHeightUnits(int units) Sets the units in which height is specified.
void	setInvalidMessage(java.lang.String invalidMessageKey) Sets the message key that is shown when the component is marked as invalid.
void	setLineWrap(boolean lineWrap) Sets wether or not the text entered can be wrapped in the component.
void	setMaximumLength(int maxLength) Sets the maximum number of characters the user can enter in the input field.
void	setNullValue(java.lang.String nullValue) Sets the input value that corresponds to a data binding property value null
void	setReadOnly(boolean readOnly) Mark this component as read-only.
void	setRequired(boolean required) Determine if the editor is required to be filled in.
void	setRows(int rows) Deprecated. use setHeight & setHeightUnits
void	setText(java.lang.String text) Sets the text in the component.
void	setToolTipText(java.lang.String toolTipText) Sets the tooltip that is shown when the user hoovers over this component.
void	setWidth(int width) Sets the width of the text field.
void	setWidthUnits(int units) Sets the units in which width is specified.

Methods inherited from class net.sf.jzeno.echo.components.CustomComponent

addValidator, fireActionEvent, fireActionEvent, fireActionEvent, getActionCommand, getBean, getBeanClass, getDecorator, getNullObject, getProperty, getValidationErrors, getValidators, getValue, isBound, isMarkedInvalid, isValid, markInvalid, markValid, preRender, removeValidator, setActionCommand, setBean, setBeanClass, setDecorator, setNullObject, setProperty, setValue, traceValue, validate

Methods inherited from class nextapp.echo.AbstractComponent

add, add, addHierarchyListener, addPropertyChangeListener, applyStyle, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getClientId, getComponent, getComponentCount, getComponents, getEchoInstance, getIdentifier, getListenerList, getLocale, getParent, indexOf, init, isAncestorOf, isDifferent, isEnabled, isFocused, isRecursivelyVisible, isRegistered, isSelectableForScriptRecorder, isShowing, isVisible, processHierarchyEvent, remove, remove, removeAll, removeHierarchyListener, removePropertyChangeListener, setClientId, setEnabled, setIdentifier, setLocale, setParent, setRegistered, setSelectableForScriptRecorder, setVisible, update

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

public static final long serialVersionUID

See Also:

Constant Field Values

CHARACTER_UNITS

public static final int CHARACTER_UNITS

See Also:

Constant Field Values

PIXEL_UNITS

public static final int PIXEL_UNITS

See Also:

Constant Field Values

PERCENT_UNITS

public static final int PERCENT_UNITS

See Also:

Constant Field Values

Constructor Detail

DynaTextArea

public DynaTextArea()

Creates an unbound component.

DynaTextArea

public DynaTextArea(java.lang.Class beanClass,
                    java.lang.String propertyName,
                    java.lang.String constructionHints)

Creates a bound component. Bind it to a String property.

Method Detail

rebind

public void rebind()

Description copied from interface: RebindableComponent

This operation causes the component to reset it's content to that of the domain model.

Specified by:

rebind in interface RebindableComponent

Overrides:

rebind in class CustomComponent

propertyChange

public void propertyChange(java.beans.PropertyChangeEvent evt)

Used internally.

Specified by:

propertyChange in interface java.beans.PropertyChangeListener

getInvalidMessage

public java.lang.String getInvalidMessage()

Gets the message key that is added to the screen, when the component is marked as invalid. Also see setInvalidMessage(String).

setInvalidMessage

public void setInvalidMessage(java.lang.String invalidMessageKey)

Sets the message key that is shown when the component is marked as invalid. Typically the component is marked invalid when you call EchoSupport.doValidationRecursively(Component) in your code. The value specified for this property is translated through the i18n support in jZeno (i18n.properties).

getMaximumLength

public int getMaximumLength()

Gets the maximum number of characters the user can enter in the input field.

setMaximumLength

public void setMaximumLength(int maxLength)

Sets the maximum number of characters the user can enter in the input field.

isAutoTrim

public boolean isAutoTrim()

Gets whether or not this component trims the input from the user. This means that any leading and/or trailing spaces are removed from the input.

setAutoTrim

public void setAutoTrim(boolean autoTrim)

Sets whether or not this component trims the input from the user. This means that any leading and/or trailing spaces are removed from the input.

getNullValue

public java.lang.String getNullValue()

Gets the input value that corresponds to a data binding property value null.

setNullValue

public void setNullValue(java.lang.String nullValue)

Sets the input value that corresponds to a data binding property value null

isReadOnly

public boolean isReadOnly()

Specified by:

isReadOnly in interface PropertyComponent

Overrides:

isReadOnly in class CustomComponent

setReadOnly

public void setReadOnly(boolean readOnly)

Description copied from interface: PropertyComponent

Mark this component as read-only.

Specified by:

setReadOnly in interface PropertyComponent

Overrides:

setReadOnly in class CustomComponent

isRequired

public boolean isRequired()

Description copied from interface: PropertyComponent

Query if the editor is required to be filled in.

Specified by:

isRequired in interface PropertyComponent

Overrides:

isRequired in class CustomComponent

setRequired

public void setRequired(boolean required)

Description copied from interface: PropertyComponent

Determine if the editor is required to be filled in.

Specified by:

setRequired in interface PropertyComponent

Overrides:

setRequired in class CustomComponent

setColumns

public void setColumns(int columns)

Deprecated. use setWidth & setWidthUnits

Sets how wide the component is on the screen. Specifies the number of character columns.

setRows

public void setRows(int rows)

Deprecated. use setHeight & setHeightUnits

Sets the number of rows to show at once on the screen.

setWidth

public void setWidth(int width)

Sets the width of the text field.

getWidth

public int getWidth()

Gets the width of the text field.

setWidthUnits

public void setWidthUnits(int units)

Sets the units in which width is specified.

getWidthUnits

public int getWidthUnits()

Gets the units in which width is specified.

setHeight

public void setHeight(int width)

Sets the height of the text area.

getHeight

public int getHeight()

Gets the height of the text area.

setHeightUnits

public void setHeightUnits(int units)

Sets the units in which height is specified.

getHeightUnits

public int getHeightUnits()

Gets the units in which height is specified.

getBackground

public Color getBackground()

Gets the background color.

Specified by:

getBackground in interface Component

Overrides:

getBackground in class AbstractComponent

Returns:

The background color of the component.

setBackground

public void setBackground(Color background)

Sets the background color.

Specified by:

setBackground in interface Component

Overrides:

setBackground in class AbstractComponent

Parameters:

background - The new background color of the component.

getForeground

public Color getForeground()

Gets the foreground (text) color.

Specified by:

getForeground in interface Component

Overrides:

getForeground in class AbstractComponent

Returns:

The foreground of the component.

setForeground

public void setForeground(Color foreground)

Sets the foreground (text) color.

Specified by:

setForeground in interface Component

Overrides:

setForeground in class AbstractComponent

Parameters:

foreground - The new foreground color of the component.

getCssClass

public java.lang.String getCssClass()

setCssClass

public void setCssClass(java.lang.String newValue)

getText

public java.lang.String getText()

Gets the text in the component.

setText

public void setText(java.lang.String text)

Sets the text in the component.

getToolTipText

public java.lang.String getToolTipText()

Gets the tooltip that is shown when the user hoovers over this component.

setToolTipText

public void setToolTipText(java.lang.String toolTipText)

Sets the tooltip that is shown when the user hoovers over this component.

setLineWrap

public void setLineWrap(boolean lineWrap)

Sets wether or not the text entered can be wrapped in the component.

getLineWrap

public boolean getLineWrap()

Gets wether or not the text entered can be wrapped in the component.

setFocused

public void setFocused(boolean focused)

Sets the input focus on this component.

Specified by:

setFocused in interface Component

Overrides:

setFocused in class AbstractComponent

Parameters:

focused - True if the component is to be focused.

setFont

public void setFont(Font font)

Description copied from interface: Component

Sets the font of the component.

Specified by:

setFont in interface Component

Overrides:

setFont in class AbstractComponent

Parameters:

font - The new font of the component.

getFont

public Font getFont()

Description copied from interface: Component

Returns the font.

Specified by:

getFont in interface Component

Overrides:

getFont in class AbstractComponent

Returns:

The font of the component.

applyContext

public void applyContext()

Specified by:

applyContext in interface Precreation

isConvertToLowerCase

public boolean isConvertToLowerCase()

setConvertToLowerCase

public void setConvertToLowerCase(boolean convertToLowerCase)

isConvertToUpperCase

public boolean isConvertToUpperCase()

setConvertToUpperCase

public void setConvertToUpperCase(boolean convertToUpperCase)