de.must.markup

Class MustTextArea

java.lang.Object

de.must.markup.MustInputField

de.must.markup.MustTextArea

All Implemented Interfaces:

Markupable, ValueFetcher

Direct Known Subclasses:

DataTextArea

public class MustTextArea
extends MustInputField

Text Input Area analogous to JTextArea to be represent by markup languages.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	cols
protected boolean	editable
protected int	maxlength
protected boolean	required
protected int	rows

Fields inherited from class de.must.markup.MustInputField

comment, focus, name, placeholder, toolTipText

Constructor Summary

Constructors

Constructor and Description
MustTextArea() Constructs a new text area with a default max. length of 254 characters.
MustTextArea(int maxlength) Constructs a new text area with a max. number of characters as specified.
MustTextArea(java.lang.String name, java.lang.String value, int maxlength) Constructs a new text area with specific name, inital value and a max.

Method Summary

Modifier and Type	Method and Description
void	destroy() Destroys the markupable.
void	fetchYourValueFromRequest(GeneralizedRequest request) Causes the component to read user input by calling request.getParameter and update the internal mirrored value.
java.lang.String	getCreationTag() Returns the tag sequence that's needed to show this object in the user interface.
java.lang.String	getText() Return the text of the text area.
boolean	isFilled() Returns true if the component has a value.
boolean	isModified() Indicates whether the component's value differs from its initial value.
boolean	isRequirementUnfulfilled() Returns true if the component's value is mandatory but not filled.
boolean	isValid() Returns true if the component's value is valid.
void	setEditable(boolean editable) Sets the specified boolean to indicate whether or not this component should be editable.
void	setRequired(boolean required) Sets the fact that user input is requested (mandatory)
void	setRows(int rows) Sets the number of rows for this TextArea.
void	setText(java.lang.String newText) Sets the text.

Methods inherited from class de.must.markup.MustInputField

getName, setComment, setFocus, setPlaceHolder, setToolTipText, toString

Methods inherited from class java.lang.Object

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

Field Detail

rows

protected int rows

cols

protected int cols

maxlength

protected int maxlength

required

protected boolean required

editable

protected boolean editable

Constructor Detail

MustTextArea

public MustTextArea()

Constructs a new text area with a default max. length of 254 characters.

MustTextArea

public MustTextArea(int maxlength)

Constructs a new text area with a max. number of characters as specified.

Parameters:

maxlength - the max. number of characters to be put in

MustTextArea

public MustTextArea(java.lang.String name,
                    java.lang.String value,
                    int maxlength)

Constructs a new text area with specific name, inital value and a max. number of characters as specified.

Parameters:

name - the name of the text area to be used

value - the intitial value of the text area

maxlength - the max. number of characters to be put in

Method Detail

setRows

public void setRows(int rows)

Sets the number of rows for this TextArea. Calls invalidate() after setting the new value.

Parameters:

rows - the number of rows >= 0

setEditable

public void setEditable(boolean editable)

Sets the specified boolean to indicate whether or not this component should be editable.

Parameters:

editable - indicates whether or not this component is editable

getCreationTag

public java.lang.String getCreationTag()

Returns the tag sequence that's needed to show this object in the user interface.

Returns:

the tag sequence to show the component

fetchYourValueFromRequest

public void fetchYourValueFromRequest(GeneralizedRequest request)

Causes the component to read user input by calling request.getParameter and update the internal mirrored value.

Specified by:

fetchYourValueFromRequest in interface ValueFetcher

Specified by:

fetchYourValueFromRequest in class MustInputField

Parameters:

request - the current request

getText

public java.lang.String getText()

Return the text of the text area.

Returns:

the text of the text area

setText

public void setText(java.lang.String newText)

Sets the text.

Parameters:

newText - the new text

setRequired

public void setRequired(boolean required)

Sets the fact that user input is requested (mandatory)

Parameters:

required - whether this inuput is mandatory or not.

isFilled

public boolean isFilled()

Returns true if the component has a value.

Returns:

true if the component has a value

isValid

public boolean isValid()

Returns true if the component's value is valid.

Returns:

true if the component's value is valid

isRequirementUnfulfilled

public boolean isRequirementUnfulfilled()

Returns true if the component's value is mandatory but not filled.

Returns:

if mandatory input is unfulfilled

isModified

public boolean isModified()

Indicates whether the component's value differs from its initial value.

Returns:

true if the component's value differs from its initial value

destroy

public void destroy()

Description copied from interface: Markupable

Destroys the markupable. Useful to release e.g. static references which prevent the garbage collector from finalizing. For example HalfDataComboBoxes add s as Listeners to database changes. These listeners are registered statically. Thus, these listeners cannot be removed by the garbage collector, they have to be removed manually. This may be done by calling this destroy method.

Specified by:

destroy in interface Markupable

Overrides:

destroy in class MustInputField

See Also:

Markupable.destroy()