to.etc.domui.dom.html
Interface IDisplayControl<T>

All Known Subinterfaces:
IControl<T>, IInputNode<T>
All Known Implementing Classes:
AbstractDivControl, Checkbox, ComboComponentBase, ComboFixed, ComboFixedClientFilter, ComboLookup, DateInput, DisplayCheckbox, DisplayHtml, DisplayOnlyPropertyBinding, DisplayValue, FCKEditor, HiddenText, HtmlEditor, LookupInput, SelectBasedControl, SimpleComponentPropertyBinding, SpanBasedControl, Text, TextArea, TextStr

public interface IDisplayControl<T>


Method Summary
 T getValue()
          Returns the current value of this input component.
 void setTestID(java.lang.String testID)
          Set the testID for external test software.
 void setValue(T v)
          Set a new value into this control.
 

Method Detail

setValue

void setValue(T v)
Set a new value into this control. Setting a value to null means the control holds no value. This value is converted to a presentable form using any (implicitly) defined converters; it will not be validated though! This means that if you set an invalid value for a validator this will not be seen until the value is gotten from the control again.

Parameters:
v -

getValue

T getValue()
Returns the current value of this input component. If the component contains no value this returns null. All text input components will return null when their value is the empty string! If the component, during conversion or validation of the input value, discovers that the input is invalid it will set itself in "error" mode, post an error message up the form, and throw a ValidationException. This means that this call either delivers correct input (as defined by it's converter and validators), null (when empty) or throws an exception. When a ValidationException occurs the framework mostly ignores it - it does not produce a stacktrace or error in the client. Instead the resulting error as posted by the error handling framework gets displayed on the form when the request completes.

To get the value of a component while ignoring exceptions call #getValueSafe().

Returns:

setTestID

void setTestID(java.lang.String testID)
Set the testID for external test software.

Parameters:
testID -