java.lang.Object
- com.iizix.prop.GProp<GProp<?>[]>
- - com.iizix.prop.PropCnr
  - - com.iizix.prop.vs.VSComponent
    - - com.iizix.prop.vs.VSField

All Implemented Interfaces:
EventListener, IFocusComp, IMessageBox, ICustomDataProvider, IGProp<GProp<?>[]>, IPatternOwner, IPropCnr, IVSComponent, IVSComponentListener, IVSComponentState, IVSMessageComponent, java.lang.Cloneable
Direct Known Subclasses:
EditorVSField
```
public class VSField
extends VSComponent
implements IVSMessageComponent, IPatternOwner
```
The VirtualSpace Field property class holds the property name, value and optionally has a parent and/or property listener(s).
The field has a raw string format or a specific data type (e.g. Date or Number). It then has a formatted string that represents a displayable field text, formatted e.g. with the correct client locale.
Author:
Christopher Mindus

Nested Class Summary
- Nested classes/interfaces inherited from interface com.iizix.gyro.IMessageBox
  IMessageBox.Icon
- Nested classes/interfaces inherited from interface com.iizix.prop.vs.IVSComponentState
  IVSComponentState.State

Field Summary
Fields
Modifier and Type Field Description
static IVSFieldListener[] EMPTY_LISTENERS
Empty listeners array.
- Fields inherited from class com.iizix.prop.vs.VSComponent
  statesMap
- Fields inherited from class com.iizix.prop.PropCnr
  EMPTY, EMPTY_CLASSES, EMPTY_CNRS, EXTENDS_FRAMEWORK_ERROR_ID
- Fields inherited from class com.iizix.prop.GProp
  GPDEBUG, PROP_ATTR_STRING_EDITOR_PROP, PROP_ATTR_STRING_ERRORED_NAME, PROP_ATTR_STRING_EXTENDS, PROP_ATTR_STRING_EXTENDS_FINAL, PROP_ATTR_STRING_EXTENDS_PRIVATE, PROP_ATTR_STRING_NULLABLE, PROP_ATTR_STRING_PRIVATE, PROP_ATTR_STRING_PRIVATE_CHANGE_EVENT, PROP_ATTR_STRING_READ_ONLY, PROP_USER_1, PROP_USER_2
- Fields inherited from interface com.iizix.prop.IGProp
  EQC_ERROR_IGNORE_ALL, EQC_ERROR_IGNORE_REFERENCES, EQC_IGNORE_ARRAY, EQC_IGNORE_VOLATILE_OR_EDITOR, EQC_PRIVATE, EQC_SAVE_FILE, EXT_CONTAINER_EXTENDS, EXT_CONTAINER_EXTENDS_VALID, EXT_EXTENDED, EXT_FINAL, EXT_OVERRIDES, EXT_OVERRIDES_FINAL_ERR, EXT_PRIVATE
- Fields inherited from interface com.iizix.gyro.IMessageBox
  ICON_ERROR, ICON_INFORMATION, ICON_MAP, ICON_NONE, ICON_QUESTION, ICON_WARNING
- Fields inherited from interface com.iizix.prop.vs.IVSComponent
  ERROR, INFORMATION, NONE, PN_IGNORE_UI_FOCUS, WARNING

Constructor Summary

Constructors
Constructor	Description
`VSField()`	Creates a VirtualSpace Field property with the specified name with a null value.
`VSField(Atom propertyAtom)`	Creates a VirtualSpace Field property with the specified name with a null value.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`boolean`	`addListener(IVSFieldListener listener)`	Adds a new listener to the VS field.
`protected void`	`addPredefinedProps()`	Adds the predefined properties for this container.
`Value`	`adjustValue(java.time.temporal.TemporalAdjuster temporalAdjuster, GProp<?> trigger)`	Adjusts the current temporal value with a temporal adjuster.
`Value`	`adjustValue(java.time.ZoneId zoneID, GProp<?> trigger)`	Adjusts the current ZonedDateTime value with a new Zone ID.
`boolean`	`assignAcceptableValue()`	Assigns an acceptable value to the field in order to be able to use it properly.
`VSField`	`clone()`	Clones this VSField.
`int`	`convertEqualsValue(GProp<?> trigger, Value... values)`	Verifies if a value could potentially be equal to the value in the field using conversion.
`protected FieldActors`	`createFieldActors()`	Creates a new instance of the field actors, overridden for the Editor.
`java.math.BigDecimal`	`get_BigDecimal()`
`java.math.BigDecimal`	`get_BigDecimal(boolean doTranslate)`
`java.math.BigDecimal`	`get_BigDecimal(boolean doTranslate, GProp<?> trigger)`
`java.math.BigDecimal`	`get_BigDecimal(GProp<?> trigger)`
`java.math.BigInteger`	`get_BigInteger()`
`java.math.BigInteger`	`get_BigInteger(boolean doTranslate)`
`java.math.BigInteger`	`get_BigInteger(boolean doTranslate, GProp<?> trigger)`
`java.math.BigInteger`	`get_BigInteger(GProp<?> trigger)`
`byte[]`	`get_Binary()`
`byte[]`	`get_Binary(boolean doTranslate)`
`byte[]`	`get_Binary(boolean doTranslate, GProp<?> trigger)`
`byte[]`	`get_Binary(GProp<?> trigger)`
`java.lang.Boolean`	`get_Boolean()`
`java.lang.Boolean`	`get_Boolean(boolean doTranslate)`
`java.lang.Boolean`	`get_Boolean(boolean doTranslate, GProp<?> trigger)`
`java.lang.Boolean`	`get_Boolean(GProp<?> trigger)`
`java.lang.Byte`	`get_Byte()`
`java.lang.Byte`	`get_Byte(boolean doTranslate)`
`java.lang.Byte`	`get_Byte(boolean doTranslate, GProp<?> trigger)`
`java.lang.Byte`	`get_Byte(GProp<?> trigger)`
`java.lang.Double`	`get_Double()`
`java.lang.Double`	`get_Double(boolean doTranslate)`
`java.lang.Double`	`get_Double(boolean doTranslate, GProp<?> trigger)`
`java.lang.Double`	`get_Double(GProp<?> trigger)`
`java.time.Duration`	`get_Duration()`
`java.time.Duration`	`get_Duration(boolean doTranslate)`
`java.time.Duration`	`get_Duration(boolean doTranslate, GProp<?> trigger)`
`java.time.Duration`	`get_Duration(GProp<?> trigger)`
`java.lang.Float`	`get_Float()`
`java.lang.Float`	`get_Float(boolean doTranslate)`
`java.lang.Float`	`get_Float(boolean doTranslate, GProp<?> trigger)`
`java.lang.Float`	`get_Float(GProp<?> trigger)`
`java.lang.Integer`	`get_Integer()`
`java.lang.Integer`	`get_Integer(boolean doTranslate)`
`java.lang.Integer`	`get_Integer(boolean doTranslate, GProp<?> trigger)`
`java.lang.Integer`	`get_Integer(GProp<?> trigger)`
`KString`	`get_KString()`	Gets the value of this field as a KString with translation and no trigger property using the field actors.
`KString`	`get_KString(boolean doTranslate)`	Gets the value of this field as a KString with translation and no trigger property using the field actors depending on the `doTranslate` flag.
`KString`	`get_KString(boolean doTranslate, GProp<?> trigger)`	Gets the value of this field as a KString with translation and optional trigger property using the field actors depending on the `doTranslate` flag.
`KString`	`get_KString(LocaleInfo localeInfo)`	Gets the value of this field as a KString with translation using the field actors.
`KString`	`get_KString(LocaleInfo localeInfo, boolean doTranslate)`	Gets the value of this field as a KString with translation using the field actors depending on the `doTranslate` flag.
`KString`	`get_KString(LocaleInfo localeInfo, boolean doTranslate, GProp<?> trigger)`	Gets the value of this field as a KString with translation and optional trigger property using the field actors depending on the `doTranslate` flag.
`KString`	`get_KString(LocaleInfo localeInfo, GProp<?> trigger)`	Gets the value of this field as a KString with translation and optional trigger property using the field actors.
`KString`	`get_KString(GProp<?> trigger)`	Gets the value of this field as a KString with translation and optional trigger property using the field actors.
`java.time.LocalDate`	`get_LocalDate()`
`java.time.LocalDate`	`get_LocalDate(boolean doTranslate)`
`java.time.LocalDate`	`get_LocalDate(boolean doTranslate, GProp<?> trigger)`
`java.time.LocalDate`	`get_LocalDate(GProp<?> trigger)`
`java.time.LocalDateTime`	`get_LocalDateTime()`
`java.time.LocalDateTime`	`get_LocalDateTime(boolean doTranslate)`
`java.time.LocalDateTime`	`get_LocalDateTime(boolean doTranslate, GProp<?> trigger)`
`java.time.LocalDateTime`	`get_LocalDateTime(GProp<?> trigger)`
`java.time.LocalTime`	`get_LocalTime()`
`java.time.LocalTime`	`get_LocalTime(boolean doTranslate)`
`java.time.LocalTime`	`get_LocalTime(boolean doTranslate, GProp<?> trigger)`
`java.time.LocalTime`	`get_LocalTime(GProp<?> trigger)`
`java.lang.Long`	`get_Long()`
`java.lang.Long`	`get_Long(boolean doTranslate)`
`java.lang.Long`	`get_Long(boolean doTranslate, GProp<?> trigger)`
`java.lang.Long`	`get_Long(GProp<?> trigger)`
`java.time.MonthDay`	`get_MonthDay()`
`java.time.MonthDay`	`get_MonthDay(boolean doTranslate)`
`java.time.MonthDay`	`get_MonthDay(boolean doTranslate, GProp<?> trigger)`
`java.time.MonthDay`	`get_MonthDay(GProp<?> trigger)`
`java.time.OffsetDateTime`	`get_OffsetDateTime()`
`java.time.OffsetDateTime`	`get_OffsetDateTime(boolean doTranslate)`
`java.time.OffsetDateTime`	`get_OffsetDateTime(boolean doTranslate, GProp<?> trigger)`
`java.time.OffsetDateTime`	`get_OffsetDateTime(GProp<?> trigger)`
`java.time.OffsetTime`	`get_OffsetTime()`
`java.time.OffsetTime`	`get_OffsetTime(boolean doTranslate)`
`java.time.OffsetTime`	`get_OffsetTime(boolean doTranslate, GProp<?> trigger)`
`java.time.OffsetTime`	`get_OffsetTime(GProp<?> trigger)`
`java.time.Period`	`get_Period()`
`java.time.Period`	`get_Period(boolean doTranslate)`
`java.time.Period`	`get_Period(boolean doTranslate, GProp<?> trigger)`
`java.time.Period`	`get_Period(GProp<?> trigger)`
`java.lang.Short`	`get_Short()`
`java.lang.Short`	`get_Short(boolean doTranslate)`
`java.lang.Short`	`get_Short(boolean doTranslate, GProp<?> trigger)`
`java.lang.Short`	`get_Short(GProp<?> trigger)`
`java.lang.String`	`get_String()`	Gets the value of this field as a String with translation and no trigger property using the field actors.
`java.lang.String`	`get_String(boolean doTranslate)`	Gets the value of this field as a String with translation and no trigger property using the field actors depending on the `doTranslate` flag.
`java.lang.String`	`get_String(boolean doTranslate, GProp<?> trigger)`	Gets the value of this field as a String with translation and optional trigger property using the field actors depending on the `doTranslate` flag.
`java.lang.String`	`get_String(LocaleInfo localeInfo)`	Gets the value of this field as a String with translation using the field actors.
`java.lang.String`	`get_String(LocaleInfo localeInfo, boolean doTranslate)`	Gets the value of this field as a String with translation using the field actors depending on the `doTranslate` flag.
`java.lang.String`	`get_String(LocaleInfo localeInfo, boolean doTranslate, GProp<?> trigger)`	Gets the value of this field as a String with translation and optional trigger property using the field actors depending on the `doTranslate` flag.
`java.lang.String`	`get_String(LocaleInfo localeInfo, GProp<?> trigger)`	Gets the value of this field as a String with translation and optional trigger property using the field actors.
`java.lang.String`	`get_String(GProp<?> trigger)`	Gets the value of this field as a String with translation and optional trigger property using the field actors.
`java.lang.String`	`get_StringRaw()`	Gets the value of this field as a String using the native Value object `toString()` method, i.e.
`javax.xml.datatype.Duration`	`get_XMLDuration()`
`javax.xml.datatype.Duration`	`get_XMLDuration(boolean doTranslate)`
`javax.xml.datatype.Duration`	`get_XMLDuration(boolean doTranslate, GProp<?> trigger)`
`javax.xml.datatype.Duration`	`get_XMLDuration(GProp<?> trigger)`
`java.time.Year`	`get_Year()`
`java.time.Year`	`get_Year(boolean doTranslate)`
`java.time.Year`	`get_Year(boolean doTranslate, GProp<?> trigger)`
`java.time.Year`	`get_Year(GProp<?> trigger)`
`java.time.YearMonth`	`get_YearMonth()`
`java.time.YearMonth`	`get_YearMonth(boolean doTranslate)`
`java.time.YearMonth`	`get_YearMonth(boolean doTranslate, GProp<?> trigger)`
`java.time.YearMonth`	`get_YearMonth(GProp<?> trigger)`
`java.time.ZonedDateTime`	`get_ZonedDateTime()`
`java.time.ZonedDateTime`	`get_ZonedDateTime(boolean doTranslate)`
`java.time.ZonedDateTime`	`get_ZonedDateTime(boolean doTranslate, GProp<?> trigger)`
`java.time.ZonedDateTime`	`get_ZonedDateTime(GProp<?> trigger)`
`FieldActors`	`getActors()`	Gets the field actors container.
`VSColumnHeader`	`getColumn()`	Gets the column instance of this field when it is in a table.
`int`	`getColumnIndex()`	Gets the column index of this field in the table.
`java.lang.String`	`getComponentIsDisabled()`	Gets the focus message for "Component is disabled" but for the component in question.
`java.lang.String`	`getComponentIsHidden()`	Gets the focus message for "Component is hidden" but for the component in question.
`IVSFieldListener[]`	`getFieldListeners()`	Gets the listeners of the VS field events.
`LocaleInfo`	`getLocaleInfo()`	Gets the cached locale information for the session, or if not available caches the one from the environment.
`LocaleInfo`	`getLocaleInfo(LocaleInfo localeInfo)`	Uses the localeInfo parameter as the locale information if non-null, otherwise gets the cached locale information for the session, or if not available caches the one from the environment.
`java.lang.String`	`getPattern()`	Gets the pattern used by the value formatter.
`PlainKString`	`getPatternPlainKString()`	Gets the pattern used by the value formatter.
`PatternProp`	`getPatternProp()`	Gets the pattern property.
`protected void`	`getPredefinedProps()`	Gets potential references to predefined properties for this container.
`Value`	`getRawValue()`	Gets the raw value of the field.
`Value.Type`	`getRawValueType()`	Gets the raw value type of the field.
`VSRow`	`getRow()`	Gets the row container.
`int`	`getRowIndex()`	Gets the row index of this field in the table.
`VSRows`	`getRows()`	Gets the rows container.
`VSTable`	`getTable()`	Gets the table.
`java.lang.Object`	`getValue(LocaleInfo localeInfo, Value.Type type, boolean doTranslate, GProp<?> trigger)`	Gets a value in the requested type with translation flag and no trigger property.
`java.lang.Object`	`getValue(Value.Type type)`	Gets a value in the requested type with translation using the field actors with translation and no trigger property.
`java.lang.Object`	`getValue(Value.Type type, boolean doTranslate)`	Gets a value in the requested type with translation flag and no trigger property.
`java.lang.Object`	`getValue(Value.Type type, boolean doTranslate, GProp<?> trigger)`	Gets a value in the requested type with translation flag and no trigger property.
`Value.Type`	`getValueType()`	Gets the value type.
`java.lang.String`	`getValueTypeString()`	Gets the value type string.
`boolean`	`isNull()`	Checks if the value is currently null.
`boolean`	`isNullAllowed()`	Sets null value allowed.
`boolean`	`isTableCell()`	Returns if this field is a table cell, i.e.
`void`	`onEventSelf(GEvent event)`	Checks for state change events and fires it to listeners.
`protected void`	`onListenerChanged(IVSFieldListener listener)`	Called when a listener is added or removed.
`void`	`onParentStateChanged(IVSComponent parent, IVSComponentState.State state, boolean stateValue)`	Invokes the parent state notification function for the component.
`protected java.lang.String`	`paramValue(java.lang.Object value)`	Formats the value as a string to add to `paramString`.
`boolean`	`removeListener(IVSFieldListener listener)`	Removes a listener from the VS field.
`boolean`	`set_BigDecimal(java.math.BigDecimal value)`
`boolean`	`set_BigDecimal(java.math.BigDecimal value, boolean doTranslate)`
`boolean`	`set_BigDecimal(java.math.BigDecimal value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_BigDecimal(java.math.BigDecimal value, GProp<?> trigger)`
`boolean`	`set_BigInteger(java.math.BigInteger value)`
`boolean`	`set_BigInteger(java.math.BigInteger value, boolean doTranslate)`
`boolean`	`set_BigInteger(java.math.BigInteger value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_BigInteger(java.math.BigInteger value, GProp<?> trigger)`
`boolean`	`set_Binary(byte[] value)`
`boolean`	`set_Binary(byte[] value, boolean doTranslate)`
`boolean`	`set_Binary(byte[] value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_Binary(byte[] value, GProp<?> trigger)`
`boolean`	`set_Boolean(java.lang.Boolean value)`
`boolean`	`set_Boolean(java.lang.Boolean value, boolean doTranslate)`
`boolean`	`set_Boolean(java.lang.Boolean value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_Boolean(java.lang.Boolean value, GProp<?> trigger)`
`boolean`	`set_Byte(java.lang.Byte value)`
`boolean`	`set_Byte(java.lang.Byte value, boolean doTranslate)`
`boolean`	`set_Byte(java.lang.Byte value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_Byte(java.lang.Byte value, GProp<?> trigger)`
`boolean`	`set_Double(java.lang.Double value)`
`boolean`	`set_Double(java.lang.Double value, boolean doTranslate)`
`boolean`	`set_Double(java.lang.Double value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_Double(java.lang.Double value, GProp<?> trigger)`
`boolean`	`set_Duration(java.time.Duration value)`
`boolean`	`set_Duration(java.time.Duration value, boolean doTranslate)`
`boolean`	`set_Duration(java.time.Duration value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_Duration(java.time.Duration value, GProp<?> trigger)`
`boolean`	`set_Float(java.lang.Float value)`
`boolean`	`set_Float(java.lang.Float value, boolean doTranslate)`
`boolean`	`set_Float(java.lang.Float value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_Float(java.lang.Float value, GProp<?> trigger)`
`boolean`	`set_Integer(java.lang.Integer value)`
`boolean`	`set_Integer(java.lang.Integer value, boolean doTranslate)`
`boolean`	`set_Integer(java.lang.Integer value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_Integer(java.lang.Integer value, GProp<?> trigger)`
`boolean`	`set_KString(KString value)`
`boolean`	`set_KString(KString value, boolean doTranslate)`
`boolean`	`set_KString(KString value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_KString(KString value, GProp<?> trigger)`
`boolean`	`set_LocalDate(java.time.LocalDate value)`
`boolean`	`set_LocalDate(java.time.LocalDate value, boolean doTranslate)`
`boolean`	`set_LocalDate(java.time.LocalDate value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_LocalDate(java.time.LocalDate value, GProp<?> trigger)`
`boolean`	`set_LocalDateTime(java.time.LocalDateTime value)`
`boolean`	`set_LocalDateTime(java.time.LocalDateTime value, boolean doTranslate)`
`boolean`	`set_LocalDateTime(java.time.LocalDateTime value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_LocalDateTime(java.time.LocalDateTime value, GProp<?> trigger)`
`boolean`	`set_LocalTime(java.time.LocalTime value)`
`boolean`	`set_LocalTime(java.time.LocalTime value, boolean doTranslate)`
`boolean`	`set_LocalTime(java.time.LocalTime value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_LocalTime(java.time.LocalTime value, GProp<?> trigger)`
`boolean`	`set_Long(java.lang.Long value)`
`boolean`	`set_Long(java.lang.Long value, boolean doTranslate)`
`boolean`	`set_Long(java.lang.Long value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_Long(java.lang.Long value, GProp<?> trigger)`
`boolean`	`set_MonthDay(java.time.MonthDay value)`
`boolean`	`set_MonthDay(java.time.MonthDay value, boolean doTranslate)`
`boolean`	`set_MonthDay(java.time.MonthDay value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_MonthDay(java.time.MonthDay value, GProp<?> trigger)`
`boolean`	`set_OffsetDateTime(java.time.OffsetDateTime value)`
`boolean`	`set_OffsetDateTime(java.time.OffsetDateTime value, boolean doTranslate)`
`boolean`	`set_OffsetDateTime(java.time.OffsetDateTime value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_OffsetDateTime(java.time.OffsetDateTime value, GProp<?> trigger)`
`boolean`	`set_OffsetTime(java.time.OffsetTime value)`
`boolean`	`set_OffsetTime(java.time.OffsetTime value, boolean doTranslate)`
`boolean`	`set_OffsetTime(java.time.OffsetTime value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_OffsetTime(java.time.OffsetTime value, GProp<?> trigger)`
`boolean`	`set_Period(java.time.Period value)`
`boolean`	`set_Period(java.time.Period value, boolean doTranslate)`
`boolean`	`set_Period(java.time.Period value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_Period(java.time.Period value, GProp<?> trigger)`
`boolean`	`set_Short(java.lang.Short value)`
`boolean`	`set_Short(java.lang.Short value, boolean doTranslate)`
`boolean`	`set_Short(java.lang.Short value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_Short(java.lang.Short value, GProp<?> trigger)`
`boolean`	`set_String(java.lang.String value)`
`boolean`	`set_String(java.lang.String value, boolean doTranslate)`
`boolean`	`set_String(java.lang.String value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_String(java.lang.String value, GProp<?> trigger)`
`boolean`	`set_XMLDuration(javax.xml.datatype.Duration value)`
`boolean`	`set_XMLDuration(javax.xml.datatype.Duration value, boolean doTranslate)`
`boolean`	`set_XMLDuration(javax.xml.datatype.Duration value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_XMLDuration(javax.xml.datatype.Duration value, GProp<?> trigger)`
`boolean`	`set_Year(java.time.Year value)`
`boolean`	`set_Year(java.time.Year value, boolean doTranslate)`
`boolean`	`set_Year(java.time.Year value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_Year(java.time.Year value, GProp<?> trigger)`
`boolean`	`set_YearMonth(java.time.YearMonth value)`
`boolean`	`set_YearMonth(java.time.YearMonth value, boolean doTranslate)`
`boolean`	`set_YearMonth(java.time.YearMonth value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_YearMonth(java.time.YearMonth value, GProp<?> trigger)`
`boolean`	`set_ZonedDateTime(java.time.ZonedDateTime value)`
`boolean`	`set_ZonedDateTime(java.time.ZonedDateTime value, boolean doTranslate)`
`boolean`	`set_ZonedDateTime(java.time.ZonedDateTime value, boolean doTranslate, GProp<?> trigger)`
`boolean`	`set_ZonedDateTime(java.time.ZonedDateTime value, GProp<?> trigger)`
`boolean`	`setNullAllowed(boolean on)`	Sets null value allowed.
`boolean`	`setNullAllowed(boolean on, IComplexOperation op)`	Sets null value allowed.
`boolean`	`setPattern(PlainKString pattern)`	Sets the pattern used by the value formatter.
`boolean`	`setPattern(PlainKString pattern, IComplexOperation op)`	Sets the pattern used by the value formatter.
`boolean`	`setRawValue(Value value, GProp<?> trigger)`	Sets the raw value of the field.
`boolean`	`setRawValue(Value value, IComplexOperation op)`	Sets the raw value of the field with undo/redo support.
`boolean`	`setValue(LocaleInfo localeInfo, java.lang.Object value, boolean doTranslate, GProp<?> trigger)`	Sets a value in generic type with possible translation and optional trigger property.
`boolean`	`setValue(java.lang.Object value, boolean doTranslate)`	Sets a value in generic type with possible translation and no trigger property.
`boolean`	`setValue(java.lang.Object value, boolean doTranslate, GProp<?> trigger)`	Sets a value in generic type with possible translation and optional trigger property.
`boolean`	`setValue(java.lang.String string)`	Sets the value as a string with error message processing.

Methods inherited from class com.iizix.prop.vs.VSComponent
addListener, areFree, areFree, canRequestFocus, couldRequestFocusIfVirtualized, forbiddenGetCustomDataMap, getClientSessionGyro, getComponentListeners, getDescription, getNonVirtualized, getVirtualSpace, initPropCnr, isFree, isFree, onFocusGained, onFocusLost, onListenerChanged, onPrepare, onPropDispose, onRemoteEvent, onVirtualizationCompleted, onVirtualized, removeListener

Methods inherited from class com.iizix.prop.PropCnr
__transferChildProps, addProp, addProp, addProp2, addProp2, appendPropValue, canRequestFocus, completeVirtualize, containsProp, containsProp, convertLoadedProp, couldRequestFocusIfVirtualized, createCopyOfAtom, createUniqueAtom, createUniqueAtom, createUniqueAtom, createVSReference, doPropEqualsArrayValues, doVirtualizePropCnr, enablePropCommunication, enablePropHashMap, equalsTree, equalsTree, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getBool, getBool, getBool, getBool, getChildPropError, getChildPropError, getChildPropErrorSeverity, getChildPropErrorSeverity, getErrorsProp, getExtendsContainer, getExtendsError, getExtendsName, getExtendsOverride, getExtendsPossibleClasses, getFirstProp, getFirstProp, getFocusEngine, getInt, getInt, getInt, getInt, getLong, getLong, getLong, getLong, getNumber, getNumber, getNumber, getNumber, getPossibleChildren, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getPropBaseReference, getPropCnr, getPropCount, getPropCount, getPropIndex, getPropIndex, getPropIndexes, getProps, getProps, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue0, getReferences, getRetargetedVerifyContainer, getString, getString, getString, getString, getValueClasses, getVSReference, hasFocus, hasSendData, initializeElement, initializeExtendsFramework, initializeProp, initializeValue, insertProp, insertProp2, isChild, isExtendsOverriden, isExtendsPropertyValid, isExtendsRoot, isPropAddRemoveAllowed, isPropCommunicating, isPropExtended, isSibling, list, list, logPropNotFound, maybeAddProp, onInsertProp, onPropRemoved, onPropTreeInitialized, onReferenceEvent, paramString, prepare, removeAllProps, removeAllProps2, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, reorderProps, replaceProps, requestFocus, requestFocus, requestFocusEx, requestFocusEx, resolveReferences, resolveRuntimeReferences, setBool, setBool, setBool, setBool, setCreateRequiredProp, setExtendsName, setExtendsOverride, setInt, setInt, setInt, setLong, setLong, setLong, setLong, setNumber, setNumber, setNumber, setNumber, setProp, setProp, setProp, setProp2, setProp2, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setString, setString, setString, setString, shouldCreateProps, shouldSerializeToXML, toElementString, toNativeValue0, usePropHashMap, usesPropIndex, validateChildPropInValue, validateClassInstances, validatePropType, validatePropValue, verify, verifyInternalUseOnly, verifyTree, virtualize

Methods inherited from class com.iizix.prop.GProp
addPropError, addPropListener, convertPropError, dispose, equals, equals, equalsErrors, equalsObj, equalsPropValue, equalValues, extendsClone, finalize, fine, fine, finer, finer, finest, finest, fromElementString, getAliasName, getAppSessionGyro, getAppWorker, getAtomPath, getAttribute, getChildReferencePropName, getClientWorker, getConstraints, getEnvironment, getErroredPropItems, getErroredProps, getErrorsProp, getExtendsRootContainer, getFullPropName, getFullPropName, getFullPropNameDebug, getFullPropNameDebug, getListeners, getModuleFolder, getModuleFolder, getParent, getParent, getProjectName, getPropAtom, getPropError, getPropError, getPropErroredName, getPropErrorSeverity, getPropExtendsFlags, getPropFromPath, getPropFromPath, getPropFromReference, getPropFromReference, getPropIndex, getPropName, getPropPath, getPropPath, getPropReferenceTarget, getPropRootPropMgr, getPropTreeErrorSeverity, getPropValue, getPropValue, getPropValueObject, getReferencePropName, getRelativePropName, getRootFromName, getRootName, getRootParent, getRootParent, getTreeLock, hasChanged, hasPrivateChangeEventProp, hasPropError, hasPropTreeError, info, info, initializeGElement, initializeGProp, isDisposed, isPropChildOf, isPropClientCreated, isPropCreateRequired, isPropExtended, isPropExtendsFinal, isPropExtendsPrivate, isPropExtendsPrivateInRoot, isPropExtendsPrivateInRoot, isPropFile, isPropFolder, isPropForEditor, isPropNullable, isPropPrivate, isPropPrivateAtCreation, isPropReadOnly, isPropReferenceTreeValid, isPropRoot, isPropUSER, isPropValueTreeLockNeeded, isPropVirtualized, isPropVirtualizing, isPropVolatile, isPropVolatileOrEditorOnly, isProxied, list, list, list, mapAliasToReference, mapAliasToReference, mapReferenceToAlias, mapReferenceToAlias, mapReferenceToProjectRelative, modifyPropValue, moveProp, moveProp, moveProp, onEvent, onPropInvalidateCache, onPropParentChanged, onPropValueSet, post, post, removePropError, removePropListener, removePropUSER, renameProp, renameProp2, resetChangedTree, setChanged, setConstraints, setConstraints, setParent, setPrivateChangeEventProp, setPrivateCreateRequiredProp, setPropError, setPropErroredName, setPropExtended, setPropExtendsFinal, setPropExtendsPrivate, setPropForEditor, setPropNullable, setPropPrivate, setPropReadOnly, setPropUSER, setPropValue, setPropValue, setPropValue, setPropValueIncognito, setPropVolatile, severe, severe, severe, shouldSerializeToXML, throwIfReadOnly, toNativeValue, toString, toString, triggerRemoteEvent, triggerRemoteEvent, validateProp, verifyHasPropertyItem, warning, warning, warning

Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.iizix.prop.ICustomDataProvider
forbiddenGetCustomDataMap, getCustomData, putCustomData, putCustomDataIfAbsent

Methods inherited from interface com.iizix.gyro.IFocusComp
onFocusGained, onFocusLost, requestFocus, requestFocus, requestFocusEx, requestFocusEx

Methods inherited from interface com.iizix.prop.IGProp
addPropError, addPropListener, dispose, equals, fine, fine, finer, finer, finest, finest, fromElementString, getAppSessionGyro, getAtomPath, getClientSessionGyro, getConstraints, getEnvironment, getErroredPropItems, getErroredProps, getErrorsProp, getExtendsRootContainer, getFullPropName, getFullPropNameDebug, getModuleFolder, getModuleFolder, getParent, getParent, getPropAtom, getPropBaseReference, getPropError, getPropError, getPropErrorSeverity, getPropExtendsFlags, getPropFromPath, getPropFromReference, getPropIndex, getPropName, getPropPath, getPropPath, getPropRootPropMgr, getPropTreeErrorSeverity, getPropValue, getPropValue, getReferencePropName, getReferences, getRelativePropName, getRootParent, getTreeLock, getValueClasses, getVSReference, hasChanged, hasPrivateChangeEventProp, hasPropError, hasPropTreeError, info, info, initializeGElement, initializeGProp, isDisposed, isPropChildOf, isPropClientCreated, isPropCommunicating, isPropCreateRequired, isPropExtended, isPropExtendsFinal, isPropExtendsPrivate, isPropExtendsPrivateInRoot, isPropExtendsPrivateInRoot, isPropFile, isPropFolder, isPropNullable, isPropPrivate, isPropReadOnly, isPropReferenceTreeValid, isPropRoot, isPropVirtualized, list, list, list, list, list, mapAliasToReference, mapReferenceToAlias, mapReferenceToProjectRelative, moveProp, moveProp, moveProp, onEvent, onPropTreeInitialized, onRemoteEvent, removePropError, removePropListener, renameProp, resolveRuntimeReferences, setChanged, setConstraints, setConstraints, setParent, setPrivateChangeEventProp, setPropError, setPropExtendsFinal, setPropExtendsPrivate, setPropNullable, setPropPrivate, setPropReadOnly, setPropValue, setPropValue, severe, severe, severe, toElementString, toNativeValue, triggerRemoteEvent, triggerRemoteEvent, validateProp, validatePropType, validatePropValue, verify, verifyHasPropertyItem, warning, warning, warning

Methods inherited from interface com.iizix.gyro.IMessageBox
messageBox, messageBox

Methods inherited from interface com.iizix.prop.IPropCnr
addProp, addProp, addProp2, addProp2, canRequestFocus, canRequestFocus, canRequestFocus, containsProp, containsProp, couldRequestFocusIfVirtualized, couldRequestFocusIfVirtualized, couldRequestFocusIfVirtualized, createCopyOfAtom, createUniqueAtom, createUniqueAtom, enablePropCommunication, enablePropHashMap, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getBool, getBool, getBool, getBool, getChildPropError, getChildPropError, getChildPropErrorSeverity, getChildPropErrorSeverity, getErrorsProp, getExtendsError, getExtendsName, getExtendsPossibleClasses, getFirstProp, getFirstProp, getFocusEngine, getInt, getInt, getInt, getInt, getLong, getLong, getLong, getLong, getNumber, getNumber, getNumber, getNumber, getPossibleChildren, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getPropCnr, getPropCount, getPropIndex, getPropIndex, getPropIndexes, getProps, getProps, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getString, getString, getString, getString, hasFocus, initializeExtendsFramework, insertProp, insertProp2, isChild, isExtendsOverriden, isExtendsRoot, isPropAddRemoveAllowed, isPropExtended, isSibling, removeAllProps, removeAllProps2, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, reorderProps, requestFocus, requestFocusEx, setBool, setBool, setBool, setBool, setExtendsName, setExtendsOverride, setInt, setInt, setInt, setLong, setLong, setLong, setLong, setNumber, setNumber, setNumber, setNumber, setProp, setProp, setProp, setProp2, setProp2, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setString, setString, setString, setString, usePropHashMap, usesPropIndex, validateClassInstances

Methods inherited from interface com.iizix.prop.vs.IVSMessageComponent
clearMessage, getMessage, getMessageCategory, getMessageString, isValid, setErrorMessage, setMessage, setMessage

Field Detail

EMPTY_LISTENERS

public static final IVSFieldListener[] EMPTY_LISTENERS

Empty listeners array.

Constructor Detail
- VSField
```
public VSField()
```
  Creates a VirtualSpace Field property with the specified name with a null value.
- VSField
```
public VSField(Atom propertyAtom)
```
  Creates a VirtualSpace Field property with the specified name with a null value.
  Parameters:
  propertyAtom - the property atom.

Method Detail

clone
```
public VSField clone()
```
Clones this VSField.
Overrides:
clone in class VSComponent

getValueType
```
public Value.Type getValueType()
```
Gets the value type.
Specified by:
getValueType in interface IPatternOwner
Returns:
The field type, or null for none.

getValueTypeString
```
public java.lang.String getValueTypeString()
```
Gets the value type string.
Returns:
The field type as Value.T_* or "<undefined>" for none.

getComponentIsHidden
```
public java.lang.String getComponentIsHidden()
```
Gets the focus message for "Component is hidden" but for the component in question.
Specified by:
getComponentIsHidden in class VSComponent

getComponentIsDisabled
```
public java.lang.String getComponentIsDisabled()
```
Gets the focus message for "Component is disabled" but for the component in question.
Specified by:
getComponentIsDisabled in class VSComponent

isTableCell
```
public boolean isTableCell()
```
Returns if this field is a table cell, i.e. inside a table or a normal field in the VirtualSpace.

getTable
```
public VSTable getTable()
```
Gets the table.
Returns:
The table instance, or null if this field is not added to a table, i.e. directly in the VirtualSpace or a VirtualSpace group.

getColumnIndex
```
public int getColumnIndex()
```
Gets the column index of this field in the table.
Returns:
The column index, or -1 if the field is not inside a table.

getRowIndex
```
public int getRowIndex()
```
Gets the row index of this field in the table.
Returns:
The row index, or -1 if the field is not inside a table, or -2 if this field in a header field.

getColumn
```
public VSColumnHeader getColumn()
```
Gets the column instance of this field when it is in a table.
Returns:
The column instance or null if not inside table or column is not found.

getRows
```
public VSRows getRows()
```
Gets the rows container.
Returns:
The rows instance, or null if field is not inside a table.

getRow
```
public VSRow getRow()
```
Gets the row container.
Returns:
The row instance, or null if field is not inside a table.

onEventSelf
```
public void onEventSelf(GEvent event)
```
Checks for state change events and fires it to listeners.
Specified by:
onEventSelf in interface IGProp<GProp<?>[]>
Overrides:
onEventSelf in class VSComponent
Parameters:
event - The property event.

onParentStateChanged
```
public void onParentStateChanged(IVSComponent parent,
                                 IVSComponentState.State state,
                                 boolean stateValue)
```
Invokes the parent state notification function for the component.
Specified by:
onParentStateChanged in interface IVSComponentListener
Parameters:
parent - The parent who's state was changed.
state - The state that changed.
stateValue - The new state value.

createFieldActors
```
protected FieldActors createFieldActors()
```
Creates a new instance of the field actors, overridden for the Editor.

getActors
```
public FieldActors getActors()
```
Gets the field actors container.
Returns:
The field actors for this field if the field is located in the VirtualSpace or in a VirtualSpace group, otherwise the table column field actors if inside a table.

addPredefinedProps
```
protected void addPredefinedProps()
                           throws PropException
```
Adds the predefined properties for this container. This method is called once just after construction of the property container and sometimes population of it.
The method should add properties to create or get reference to using the maybeAddProp method. When the PropCnr instance is cloned, the method getPredefinedProps() is called in order for the subclass to be able to retrieve the new instances to these properties, if stored in instance variables.
Overrides:
addPredefinedProps in class PropCnr
Throws:
PropException - for property exceptions.

getPredefinedProps
```
protected void getPredefinedProps()
```
Gets potential references to predefined properties for this container. This method is called once just after cloning of the property container.
The method should get reference to using the getProp(...) methods. This allows the subclass to be able to retrieve the new instances to the properties created during addPredefinedProps() if stored in instance variables.
Overrides:
getPredefinedProps in class PropCnr

addListener
```
public boolean addListener(IVSFieldListener listener)
```
Adds a new listener to the VS field.
Parameters:
listener - The listener for VS field events.
Returns:
true for success, false if the listener already is added.

removeListener
```
public boolean removeListener(IVSFieldListener listener)
```
Removes a listener from the VS field.
Parameters:
listener - The existing listener for VS field events.
Returns:
true for success, false if the listener has not been added.

onListenerChanged
```
protected void onListenerChanged(IVSFieldListener listener)
```
Called when a listener is added or removed. This method is overridden by the Designer to update connections.

getFieldListeners
```
public IVSFieldListener[] getFieldListeners()
```
Gets the listeners of the VS field events.
Returns:
A cached array of listeners for the value, retrieved without synchronization if possible.

setNullAllowed
```
public boolean setNullAllowed(boolean on)
```
Sets null value allowed. If null is not allowed and the value is null when this method is called, nothing happens, a validation must be done first.
Parameters:
on - The null allowed state.
Returns:
true for change, false for no change.

setNullAllowed
```
public boolean setNullAllowed(boolean on,
                              IComplexOperation op)
```
Sets null value allowed. If null is not allowed and the value is null when this method is called, nothing happens, a validation must be done first.
This method supports undo/redo.
Parameters:
on - The null allowed state.
Returns:
true for change, false for no change.

isNullAllowed
```
public boolean isNullAllowed()
```
Sets null value allowed. If null is not allowed and the value is null when this method is called, nothing happens, a validation must be done first.
Default is true.
Returns:
true if null value is allowed, false otherwise.

setRawValue
```
public boolean setRawValue(Value value,
                           GProp<?> trigger)
```
Sets the raw value of the field. If the Raw Value property cannot be set, a warning is logged.
If the value is a Value instance but Value.isNull() returns true but the null is not allowed, a warning is logged and nothing is done.
Parameters:
value - The raw value.
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
true If the value changed, false otherwise.
Throws:
java.lang.NullPointerException - If value is null.

setRawValue
```
public boolean setRawValue(Value value,
                           IComplexOperation op)
```
Sets the raw value of the field with undo/redo support. If the Raw Value property cannot be set, a warning is logged.
If the value is a Value instance but Value.isNull() returns true but the null is not allowed, a warning is logged and nothing is done.
Parameters:
value - The raw value.
Returns:
true If the value changed, false otherwise.
Throws:
java.lang.NullPointerException - If value is null.

getRawValue
```
public Value getRawValue()
```
Gets the raw value of the field.
Returns:
null If not set yet.

getRawValueType
```
public Value.Type getRawValueType()
```
Gets the raw value type of the field.
Returns:
The Value type, or null if not set.

isNull
```
public boolean isNull()
```
Checks if the value is currently null.
Returns:
true if value is null, false otherwise.

assignAcceptableValue
```
public boolean assignAcceptableValue()
```
Assigns an acceptable value to the field in order to be able to use it properly. This method is intended to be used when conversion failures, etc, are found when e.g. populating a table.
This method does nothing if the current value is acceptable, i.e. has been set or is null and this is allowed.
If the raw field type is not set, String is assumed.
Returns:
true for changed, false for no change.

setPattern
```
public boolean setPattern(PlainKString pattern)
```
Sets the pattern used by the value formatter.
Parameters:
pattern - The pattern to set, null to remove.
Returns:
true if this property changed, false otherwise.

setPattern
```
public boolean setPattern(PlainKString pattern,
                          IComplexOperation op)
```
Sets the pattern used by the value formatter.
Parameters:
pattern - The pattern to set, null to remove.
op - The complex operation for undo/redo.
Returns:
true if this property changed, false otherwise.

getPatternProp
```
public PatternProp getPatternProp()
```
Gets the pattern property.
Note: if the field is in a table, the pattern property for the field is not used, rather the pattern property of the corresponding table column.
Specified by:
getPatternProp in interface IPatternOwner
Returns:
The pattern property, or null for none. If the field is in a table, the corresponding table column pattern property is returned instead.

getPattern
```
public java.lang.String getPattern()
```
Gets the pattern used by the value formatter. This method will resolve the pattern if the pattern PlainKString contains tags.
Note: if the field is in a table, the pattern property for the field is not used, rather the pattern property of the corresponding table column.
Returns:
The pattern, null for none. If the field is in a table, the corresponding table column pattern is returned instead.

getPatternPlainKString
```
public PlainKString getPatternPlainKString()
```
Gets the pattern used by the value formatter.
Note: if the field is in a table, the pattern property for the field is not used, rather the pattern property of the corresponding table column.
Returns:
The pattern, null for none. If the field is in a table, the corresponding table column pattern is returned instead.

setValue
```
public boolean setValue(java.lang.String string)
```
Sets the value as a string with error message processing. This method is intended to be used by the framework and should normally not be called. Use set_String(String) instead.
Parameters:
string - The new value, potentially null for a null value.
Returns:
true for changes to the field, false for no change.

get_StringRaw
```
public java.lang.String get_StringRaw()
```
Gets the value of this field as a String using the native Value object toString() method, i.e. without translators, pattern and localization.
Returns:
The String value, or null if the Value.isNull() returns true.

get_String
```
public java.lang.String get_String()
```
Gets the value of this field as a String with translation and no trigger property using the field actors.
Conversion of the value is done as required using the session Locale settings and Pattern.
The ValueConversionException that may be thrown by other field "get_String" routines is caught by this method and logged as a warning.
Returns:
The String value, or null if the Value.isNull() returns true.

get_String
```
public java.lang.String get_String(boolean doTranslate)
                            throws ValueConversionException
```
Gets the value of this field as a String with translation and no trigger property using the field actors depending on the doTranslate flag.
Conversion of the value is done as required using the session Locale settings and Pattern.
The get_String() methods, as opposed to the other get_String() routines does not throw a ValueConversionException.
Parameters:
doTranslate - Translate the value using the field actors.
Returns:
The String value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_String
```
public java.lang.String get_String(LocaleInfo localeInfo)
                            throws ValueConversionException
```
Gets the value of this field as a String with translation using the field actors. Conversion of the value is done as required using the session Locale settings and Pattern.
The get_String() methods, as opposed to the other get_String() methods does not throw a ValueConversionException.
Parameters:
localeInfo - The LocaleInfo to use.
Returns:
The String value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_String
```
public java.lang.String get_String(GProp<?> trigger)
                            throws ValueConversionException
```
Gets the value of this field as a String with translation and optional trigger property using the field actors.
Conversion of the value is done as required using the session Locale settings and Pattern.
The get_String() methods, as opposed to the other get_String() methods does not throw a ValueConversionException.
Parameters:
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
The String value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_String
```
public java.lang.String get_String(boolean doTranslate,
                                   GProp<?> trigger)
                            throws ValueConversionException
```
Gets the value of this field as a String with translation and optional trigger property using the field actors depending on the doTranslate flag.
Conversion of the value is done as required using the session Locale settings and Pattern.
The get_String() methods, as opposed to the other get_String() methods does not throw a ValueConversionException.
Parameters:
doTranslate - Translate the value using the field actors.
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
The String value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_String
```
public java.lang.String get_String(LocaleInfo localeInfo,
                                   GProp<?> trigger)
                            throws ValueConversionException
```
Gets the value of this field as a String with translation and optional trigger property using the field actors. Conversion of the value is done as required using the session Locale settings and Pattern.
The get_String() methods, as opposed to the other get_String() methods does not throw a ValueConversionException.
Parameters:
localeInfo - The LocaleInfo to use.
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
The String value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_String
```
public java.lang.String get_String(LocaleInfo localeInfo,
                                   boolean doTranslate)
                            throws ValueConversionException
```
Gets the value of this field as a String with translation using the field actors depending on the doTranslate flag.
Conversion of the value is done as required using the session Locale settings and Pattern.
The get_String() methods, as opposed to the other get_String() methods does not throw a ValueConversionException.
Parameters:
localeInfo - The LocaleInfo to use.
doTranslate - Translate the value using the field actors.
Returns:
The String value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_String
```
public java.lang.String get_String(LocaleInfo localeInfo,
                                   boolean doTranslate,
                                   GProp<?> trigger)
                            throws ValueConversionException
```
Gets the value of this field as a String with translation and optional trigger property using the field actors depending on the doTranslate flag.
Conversion of the value is done as required using the session Locale settings and Pattern.
The get_String() methods, as opposed to the other get_String() methods does not throw a ValueConversionException.
Parameters:
localeInfo - The LocaleInfo to use.
doTranslate - Translate the value using the field actors.
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
The String value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

getLocaleInfo
```
public LocaleInfo getLocaleInfo()
```
Gets the cached locale information for the session, or if not available caches the one from the environment.
Returns:
The locale information, never null.

getLocaleInfo
```
public LocaleInfo getLocaleInfo(LocaleInfo localeInfo)
```
Uses the localeInfo parameter as the locale information if non-null, otherwise gets the cached locale information for the session, or if not available caches the one from the environment.
Returns:
The locale information, never null.

get_KString
```
public KString get_KString()
```
Gets the value of this field as a KString with translation and no trigger property using the field actors.
Conversion of the value is done as required using the session Locale settings and Pattern.
The ValueConversionException that may be thrown by other field "get_KString" routines is caught by this method and logged as a warning.
Returns:
The KString value, or null if the Value.isNull() returns true.

get_KString
```
public KString get_KString(boolean doTranslate)
                    throws ValueConversionException
```
Gets the value of this field as a KString with translation and no trigger property using the field actors depending on the doTranslate flag.
Conversion of the value is done as required using the session Locale settings and Pattern.
The get_KString() method, as opposed to the other get_KString() methods does not throw a ValueConversionException.
Parameters:
doTranslate - Translate the value using the field actors.
Returns:
The KString value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_KString
```
public KString get_KString(LocaleInfo localeInfo)
                    throws ValueConversionException
```
Gets the value of this field as a KString with translation using the field actors. Conversion of the value is done as required using the session Locale settings and Pattern.
The get_KString() method, as opposed to the other get_KString() methods does not throw a ValueConversionException.
Parameters:
localeInfo - The LocaleInfo to use.
Returns:
The KString value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_KString
```
public KString get_KString(GProp<?> trigger)
                    throws ValueConversionException
```
Gets the value of this field as a KString with translation and optional trigger property using the field actors.
Conversion of the value is done as required using the session Locale settings and Pattern.
The get_KString() method, as opposed to the other get_KString() methods does not throw a ValueConversionException.
Parameters:
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
The KString value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_KString
```
public KString get_KString(boolean doTranslate,
                           GProp<?> trigger)
                    throws ValueConversionException
```
Gets the value of this field as a KString with translation and optional trigger property using the field actors depending on the doTranslate flag.
Conversion of the value is done as required using the session Locale settings and Pattern.
The get_KString() method, as opposed to the other get_KString() methods does not throw a ValueConversionException.
Parameters:
doTranslate - Translate the value using the field actors.
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
The KString value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_KString
```
public KString get_KString(LocaleInfo localeInfo,
                           GProp<?> trigger)
                    throws ValueConversionException
```
Gets the value of this field as a KString with translation and optional trigger property using the field actors. Conversion of the value is done as required using the session Locale settings and Pattern.
The get_KString() method, as opposed to the other get_KString() methods does not throw a ValueConversionException.
Parameters:
localeInfo - The LocaleInfo to use.
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
The KString value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_KString
```
public KString get_KString(LocaleInfo localeInfo,
                           boolean doTranslate)
                    throws ValueConversionException
```
Gets the value of this field as a KString with translation using the field actors depending on the doTranslate flag.
Conversion of the value is done as required using the session Locale settings and Pattern.
The get_KString() method, as opposed to the other get_KString() methods does not throw a ValueConversionException.
Parameters:
localeInfo - The LocaleInfo to use.
doTranslate - Translate the value using the field actors.
Returns:
The KString value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_KString
```
public KString get_KString(LocaleInfo localeInfo,
                           boolean doTranslate,
                           GProp<?> trigger)
                    throws ValueConversionException
```
Gets the value of this field as a KString with translation and optional trigger property using the field actors depending on the doTranslate flag.
Conversion of the value is done as required using the session Locale settings and Pattern.
The get_KString() method, as opposed to the other get_KString() methods does not throw a ValueConversionException.
Parameters:
localeInfo - The LocaleInfo to use.
doTranslate - Translate the value using the field actors.
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
The KString value, or null if the Value.isNull() returns true.
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

get_XMLDuration

public javax.xml.datatype.Duration get_XMLDuration()
                                            throws ValueConversionException

Throws:: ValueConversionException

get_BigDecimal

public java.math.BigDecimal get_BigDecimal()
                                    throws ValueConversionException

Throws:: ValueConversionException

get_BigInteger

public java.math.BigInteger get_BigInteger()
                                    throws ValueConversionException

Throws:: ValueConversionException

get_Binary

public byte[] get_Binary()
                  throws ValueConversionException

Throws:: ValueConversionException

get_Boolean

public java.lang.Boolean get_Boolean()
                              throws ValueConversionException

Throws:: ValueConversionException

get_Byte

public java.lang.Byte get_Byte()
                        throws ValueConversionException

Throws:: ValueConversionException

get_Double

public java.lang.Double get_Double()
                            throws ValueConversionException

Throws:: ValueConversionException

get_Duration

public java.time.Duration get_Duration()
                                throws ValueConversionException

Throws:: ValueConversionException

get_Float

public java.lang.Float get_Float()
                          throws ValueConversionException

Throws:: ValueConversionException

get_Integer

public java.lang.Integer get_Integer()
                              throws ValueConversionException

Throws:: ValueConversionException

get_LocalDateTime

public java.time.LocalDateTime get_LocalDateTime()
                                          throws ValueConversionException

Throws:: ValueConversionException

get_LocalDate

public java.time.LocalDate get_LocalDate()
                                  throws ValueConversionException

Throws:: ValueConversionException

get_LocalTime

public java.time.LocalTime get_LocalTime()
                                  throws ValueConversionException

Throws:: ValueConversionException

get_Long

public java.lang.Long get_Long()
                        throws ValueConversionException

Throws:: ValueConversionException

get_MonthDay

public java.time.MonthDay get_MonthDay()
                                throws ValueConversionException

Throws:: ValueConversionException

get_OffsetDateTime

public java.time.OffsetDateTime get_OffsetDateTime()
                                            throws ValueConversionException

Throws:: ValueConversionException

get_OffsetTime

public java.time.OffsetTime get_OffsetTime()
                                    throws ValueConversionException

Throws:: ValueConversionException

get_Period

public java.time.Period get_Period()
                            throws ValueConversionException

Throws:: ValueConversionException

get_Short

public java.lang.Short get_Short()
                          throws ValueConversionException

Throws:: ValueConversionException

get_YearMonth

public java.time.YearMonth get_YearMonth()
                                  throws ValueConversionException

Throws:: ValueConversionException

get_Year

public java.time.Year get_Year()
                        throws ValueConversionException

Throws:: ValueConversionException

get_ZonedDateTime

public java.time.ZonedDateTime get_ZonedDateTime()
                                          throws ValueConversionException

Throws:: ValueConversionException

get_XMLDuration

public javax.xml.datatype.Duration get_XMLDuration(boolean doTranslate)
                                            throws ValueConversionException

Throws:: ValueConversionException

get_BigDecimal

public java.math.BigDecimal get_BigDecimal(boolean doTranslate)
                                    throws ValueConversionException

Throws:: ValueConversionException

get_BigInteger

public java.math.BigInteger get_BigInteger(boolean doTranslate)
                                    throws ValueConversionException

Throws:: ValueConversionException

get_Binary

public byte[] get_Binary(boolean doTranslate)
                  throws ValueConversionException

Throws:: ValueConversionException

get_Boolean

public java.lang.Boolean get_Boolean(boolean doTranslate)
                              throws ValueConversionException

Throws:: ValueConversionException

get_Byte

public java.lang.Byte get_Byte(boolean doTranslate)
                        throws ValueConversionException

Throws:: ValueConversionException

get_Double

public java.lang.Double get_Double(boolean doTranslate)
                            throws ValueConversionException

Throws:: ValueConversionException

get_Duration

public java.time.Duration get_Duration(boolean doTranslate)
                                throws ValueConversionException

Throws:: ValueConversionException

get_Float

public java.lang.Float get_Float(boolean doTranslate)
                          throws ValueConversionException

Throws:: ValueConversionException

get_Integer

public java.lang.Integer get_Integer(boolean doTranslate)
                              throws ValueConversionException

Throws:: ValueConversionException

get_LocalDateTime

public java.time.LocalDateTime get_LocalDateTime(boolean doTranslate)
                                          throws ValueConversionException

Throws:: ValueConversionException

get_LocalDate

public java.time.LocalDate get_LocalDate(boolean doTranslate)
                                  throws ValueConversionException

Throws:: ValueConversionException

get_LocalTime

public java.time.LocalTime get_LocalTime(boolean doTranslate)
                                  throws ValueConversionException

Throws:: ValueConversionException

get_Long

public java.lang.Long get_Long(boolean doTranslate)
                        throws ValueConversionException

Throws:: ValueConversionException

get_MonthDay

public java.time.MonthDay get_MonthDay(boolean doTranslate)
                                throws ValueConversionException

Throws:: ValueConversionException

get_OffsetDateTime

public java.time.OffsetDateTime get_OffsetDateTime(boolean doTranslate)
                                            throws ValueConversionException

Throws:: ValueConversionException

get_OffsetTime

public java.time.OffsetTime get_OffsetTime(boolean doTranslate)
                                    throws ValueConversionException

Throws:: ValueConversionException

get_Period

public java.time.Period get_Period(boolean doTranslate)
                            throws ValueConversionException

Throws:: ValueConversionException

get_Short

public java.lang.Short get_Short(boolean doTranslate)
                          throws ValueConversionException

Throws:: ValueConversionException

get_YearMonth

public java.time.YearMonth get_YearMonth(boolean doTranslate)
                                  throws ValueConversionException

Throws:: ValueConversionException

get_Year

public java.time.Year get_Year(boolean doTranslate)
                        throws ValueConversionException

Throws:: ValueConversionException

get_ZonedDateTime

public java.time.ZonedDateTime get_ZonedDateTime(boolean doTranslate)
                                          throws ValueConversionException

Throws:: ValueConversionException

get_XMLDuration

public javax.xml.datatype.Duration get_XMLDuration(GProp<?> trigger)
                                            throws ValueConversionException

Throws:: ValueConversionException

get_BigDecimal

public java.math.BigDecimal get_BigDecimal(GProp<?> trigger)
                                    throws ValueConversionException

Throws:: ValueConversionException

get_BigInteger

public java.math.BigInteger get_BigInteger(GProp<?> trigger)
                                    throws ValueConversionException

Throws:: ValueConversionException

get_Binary

public byte[] get_Binary(GProp<?> trigger)
                  throws ValueConversionException

Throws:: ValueConversionException

get_Boolean

public java.lang.Boolean get_Boolean(GProp<?> trigger)
                              throws ValueConversionException

Throws:: ValueConversionException

get_Byte

public java.lang.Byte get_Byte(GProp<?> trigger)
                        throws ValueConversionException

Throws:: ValueConversionException

get_Double

public java.lang.Double get_Double(GProp<?> trigger)
                            throws ValueConversionException

Throws:: ValueConversionException

get_Duration

public java.time.Duration get_Duration(GProp<?> trigger)
                                throws ValueConversionException

Throws:: ValueConversionException

get_Float

public java.lang.Float get_Float(GProp<?> trigger)
                          throws ValueConversionException

Throws:: ValueConversionException

get_Integer

public java.lang.Integer get_Integer(GProp<?> trigger)
                              throws ValueConversionException

Throws:: ValueConversionException

get_LocalDateTime

public java.time.LocalDateTime get_LocalDateTime(GProp<?> trigger)
                                          throws ValueConversionException

Throws:: ValueConversionException

get_LocalDate

public java.time.LocalDate get_LocalDate(GProp<?> trigger)
                                  throws ValueConversionException

Throws:: ValueConversionException

get_LocalTime

public java.time.LocalTime get_LocalTime(GProp<?> trigger)
                                  throws ValueConversionException

Throws:: ValueConversionException

get_Long

public java.lang.Long get_Long(GProp<?> trigger)
                        throws ValueConversionException

Throws:: ValueConversionException

get_MonthDay

public java.time.MonthDay get_MonthDay(GProp<?> trigger)
                                throws ValueConversionException

Throws:: ValueConversionException

get_OffsetDateTime

public java.time.OffsetDateTime get_OffsetDateTime(GProp<?> trigger)
                                            throws ValueConversionException

Throws:: ValueConversionException

get_OffsetTime

public java.time.OffsetTime get_OffsetTime(GProp<?> trigger)
                                    throws ValueConversionException

Throws:: ValueConversionException

get_Period

public java.time.Period get_Period(GProp<?> trigger)
                            throws ValueConversionException

Throws:: ValueConversionException

get_Short

public java.lang.Short get_Short(GProp<?> trigger)
                          throws ValueConversionException

Throws:: ValueConversionException

get_YearMonth

public java.time.YearMonth get_YearMonth(GProp<?> trigger)
                                  throws ValueConversionException

Throws:: ValueConversionException

get_Year

public java.time.Year get_Year(GProp<?> trigger)
                        throws ValueConversionException

Throws:: ValueConversionException

get_ZonedDateTime

public java.time.ZonedDateTime get_ZonedDateTime(GProp<?> trigger)
                                          throws ValueConversionException

Throws:: ValueConversionException

get_XMLDuration

public javax.xml.datatype.Duration get_XMLDuration(boolean doTranslate,
                                                   GProp<?> trigger)
                                            throws ValueConversionException

Throws:: ValueConversionException

get_BigDecimal

public java.math.BigDecimal get_BigDecimal(boolean doTranslate,
                                           GProp<?> trigger)
                                    throws ValueConversionException

Throws:: ValueConversionException

get_BigInteger

public java.math.BigInteger get_BigInteger(boolean doTranslate,
                                           GProp<?> trigger)
                                    throws ValueConversionException

Throws:: ValueConversionException

get_Binary

public byte[] get_Binary(boolean doTranslate,
                         GProp<?> trigger)
                  throws ValueConversionException

Throws:: ValueConversionException

get_Boolean

public java.lang.Boolean get_Boolean(boolean doTranslate,
                                     GProp<?> trigger)
                              throws ValueConversionException

Throws:: ValueConversionException

get_Byte

public java.lang.Byte get_Byte(boolean doTranslate,
                               GProp<?> trigger)
                        throws ValueConversionException

Throws:: ValueConversionException

get_Double

public java.lang.Double get_Double(boolean doTranslate,
                                   GProp<?> trigger)
                            throws ValueConversionException

Throws:: ValueConversionException

get_Duration

public java.time.Duration get_Duration(boolean doTranslate,
                                       GProp<?> trigger)
                                throws ValueConversionException

Throws:: ValueConversionException

get_Float

public java.lang.Float get_Float(boolean doTranslate,
                                 GProp<?> trigger)
                          throws ValueConversionException

Throws:: ValueConversionException

get_Integer

public java.lang.Integer get_Integer(boolean doTranslate,
                                     GProp<?> trigger)
                              throws ValueConversionException

Throws:: ValueConversionException

get_LocalDateTime

public java.time.LocalDateTime get_LocalDateTime(boolean doTranslate,
                                                 GProp<?> trigger)
                                          throws ValueConversionException

Throws:: ValueConversionException

get_LocalDate

public java.time.LocalDate get_LocalDate(boolean doTranslate,
                                         GProp<?> trigger)
                                  throws ValueConversionException

Throws:: ValueConversionException

get_LocalTime

public java.time.LocalTime get_LocalTime(boolean doTranslate,
                                         GProp<?> trigger)
                                  throws ValueConversionException

Throws:: ValueConversionException

get_Long

public java.lang.Long get_Long(boolean doTranslate,
                               GProp<?> trigger)
                        throws ValueConversionException

Throws:: ValueConversionException

get_MonthDay

public java.time.MonthDay get_MonthDay(boolean doTranslate,
                                       GProp<?> trigger)
                                throws ValueConversionException

Throws:: ValueConversionException

get_OffsetDateTime

public java.time.OffsetDateTime get_OffsetDateTime(boolean doTranslate,
                                                   GProp<?> trigger)
                                            throws ValueConversionException

Throws:: ValueConversionException

get_OffsetTime

public java.time.OffsetTime get_OffsetTime(boolean doTranslate,
                                           GProp<?> trigger)
                                    throws ValueConversionException

Throws:: ValueConversionException

get_Period

public java.time.Period get_Period(boolean doTranslate,
                                   GProp<?> trigger)
                            throws ValueConversionException

Throws:: ValueConversionException

get_Short

public java.lang.Short get_Short(boolean doTranslate,
                                 GProp<?> trigger)
                          throws ValueConversionException

Throws:: ValueConversionException

get_YearMonth

public java.time.YearMonth get_YearMonth(boolean doTranslate,
                                         GProp<?> trigger)
                                  throws ValueConversionException

Throws:: ValueConversionException

get_Year

public java.time.Year get_Year(boolean doTranslate,
                               GProp<?> trigger)
                        throws ValueConversionException

Throws:: ValueConversionException

get_ZonedDateTime

public java.time.ZonedDateTime get_ZonedDateTime(boolean doTranslate,
                                                 GProp<?> trigger)
                                          throws ValueConversionException

Throws:: ValueConversionException

getValue
```
public java.lang.Object getValue(Value.Type type)
                          throws ValueConversionException
```
Gets a value in the requested type with translation using the field actors with translation and no trigger property. The user sessions Locale is used.
Parameters:
type - Any of the Value types.
Returns:
The value according to the type class, or null if the value is null (i.e. has Value.isNull()).
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

getValue
```
public java.lang.Object getValue(Value.Type type,
                                 boolean doTranslate)
                          throws ValueConversionException
```
Gets a value in the requested type with translation flag and no trigger property. The user sessions Locale is used.
Parameters:
type - Any of the Value types.
doTranslate - Translate the value using the field actors.
Returns:
The value according to the type class, or null if the value is null (i.e. has Value.isNull()).
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

getValue
```
public java.lang.Object getValue(Value.Type type,
                                 boolean doTranslate,
                                 GProp<?> trigger)
                          throws ValueConversionException
```
Gets a value in the requested type with translation flag and no trigger property. The user sessions Locale is used.
Parameters:
type - Any of the Value types.
doTranslate - Translate the value using the field actors.
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
The value according to the type class, or null if the value is null (i.e. has Value.isNull()).
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

getValue
```
public java.lang.Object getValue(LocaleInfo localeInfo,
                                 Value.Type type,
                                 boolean doTranslate,
                                 GProp<?> trigger)
                          throws ValueConversionException
```
Gets a value in the requested type with translation flag and no trigger property. The user sessions Locale is used.
Parameters:
localeInfo - The locale info or null for default.
type - Any of the Value types.
doTranslate - Translate the value using the field actors.
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
The value according to the type class, or null if the value is null (i.e. has Value.isNull()).
Throws:
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

set_XMLDuration

public boolean set_XMLDuration(javax.xml.datatype.Duration value)
                        throws ValueConversionException

Throws:: ValueConversionException

set_BigDecimal

public boolean set_BigDecimal(java.math.BigDecimal value)
                       throws ValueConversionException

Throws:: ValueConversionException

set_BigInteger

public boolean set_BigInteger(java.math.BigInteger value)
                       throws ValueConversionException

Throws:: ValueConversionException

set_Binary

public boolean set_Binary(byte[] value)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Boolean

public boolean set_Boolean(java.lang.Boolean value)
                    throws ValueConversionException

Throws:: ValueConversionException

set_Byte

public boolean set_Byte(java.lang.Byte value)
                 throws ValueConversionException

Throws:: ValueConversionException

set_Double

public boolean set_Double(java.lang.Double value)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Duration

public boolean set_Duration(java.time.Duration value)
                     throws ValueConversionException

Throws:: ValueConversionException

set_Float

public boolean set_Float(java.lang.Float value)
                  throws ValueConversionException

Throws:: ValueConversionException

set_Integer

public boolean set_Integer(java.lang.Integer value)
                    throws ValueConversionException

Throws:: ValueConversionException

set_KString

public boolean set_KString(KString value)
                    throws ValueConversionException

Throws:: ValueConversionException

set_LocalDateTime

public boolean set_LocalDateTime(java.time.LocalDateTime value)
                          throws ValueConversionException

Throws:: ValueConversionException

set_LocalDate

public boolean set_LocalDate(java.time.LocalDate value)
                      throws ValueConversionException

Throws:: ValueConversionException

set_LocalTime

public boolean set_LocalTime(java.time.LocalTime value)
                      throws ValueConversionException

Throws:: ValueConversionException

set_Long

public boolean set_Long(java.lang.Long value)
                 throws ValueConversionException

Throws:: ValueConversionException

set_MonthDay

public boolean set_MonthDay(java.time.MonthDay value)
                     throws ValueConversionException

Throws:: ValueConversionException

set_OffsetDateTime

public boolean set_OffsetDateTime(java.time.OffsetDateTime value)
                           throws ValueConversionException

Throws:: ValueConversionException

set_OffsetTime

public boolean set_OffsetTime(java.time.OffsetTime value)
                       throws ValueConversionException

Throws:: ValueConversionException

set_Period

public boolean set_Period(java.time.Period value)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Short

public boolean set_Short(java.lang.Short value)
                  throws ValueConversionException

Throws:: ValueConversionException

set_String

public boolean set_String(java.lang.String value)
                   throws ValueConversionException

Throws:: ValueConversionException

set_YearMonth

public boolean set_YearMonth(java.time.YearMonth value)
                      throws ValueConversionException

Throws:: ValueConversionException

set_Year

public boolean set_Year(java.time.Year value)
                 throws ValueConversionException

Throws:: ValueConversionException

set_ZonedDateTime

public boolean set_ZonedDateTime(java.time.ZonedDateTime value)
                          throws ValueConversionException

Throws:: ValueConversionException

set_XMLDuration

public boolean set_XMLDuration(javax.xml.datatype.Duration value,
                               boolean doTranslate)
                        throws ValueConversionException

Throws:: ValueConversionException

set_BigDecimal

public boolean set_BigDecimal(java.math.BigDecimal value,
                              boolean doTranslate)
                       throws ValueConversionException

Throws:: ValueConversionException

set_BigInteger

public boolean set_BigInteger(java.math.BigInteger value,
                              boolean doTranslate)
                       throws ValueConversionException

Throws:: ValueConversionException

set_Binary

public boolean set_Binary(byte[] value,
                          boolean doTranslate)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Boolean

public boolean set_Boolean(java.lang.Boolean value,
                           boolean doTranslate)
                    throws ValueConversionException

Throws:: ValueConversionException

set_Byte

public boolean set_Byte(java.lang.Byte value,
                        boolean doTranslate)
                 throws ValueConversionException

Throws:: ValueConversionException

set_Double

public boolean set_Double(java.lang.Double value,
                          boolean doTranslate)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Duration

public boolean set_Duration(java.time.Duration value,
                            boolean doTranslate)
                     throws ValueConversionException

Throws:: ValueConversionException

set_Float

public boolean set_Float(java.lang.Float value,
                         boolean doTranslate)
                  throws ValueConversionException

Throws:: ValueConversionException

set_Integer

public boolean set_Integer(java.lang.Integer value,
                           boolean doTranslate)
                    throws ValueConversionException

Throws:: ValueConversionException

set_KString

public boolean set_KString(KString value,
                           boolean doTranslate)
                    throws ValueConversionException

Throws:: ValueConversionException

set_LocalDateTime

public boolean set_LocalDateTime(java.time.LocalDateTime value,
                                 boolean doTranslate)
                          throws ValueConversionException

Throws:: ValueConversionException

set_LocalDate

public boolean set_LocalDate(java.time.LocalDate value,
                             boolean doTranslate)
                      throws ValueConversionException

Throws:: ValueConversionException

set_LocalTime

public boolean set_LocalTime(java.time.LocalTime value,
                             boolean doTranslate)
                      throws ValueConversionException

Throws:: ValueConversionException

set_Long

public boolean set_Long(java.lang.Long value,
                        boolean doTranslate)
                 throws ValueConversionException

Throws:: ValueConversionException

set_MonthDay

public boolean set_MonthDay(java.time.MonthDay value,
                            boolean doTranslate)
                     throws ValueConversionException

Throws:: ValueConversionException

set_OffsetDateTime

public boolean set_OffsetDateTime(java.time.OffsetDateTime value,
                                  boolean doTranslate)
                           throws ValueConversionException

Throws:: ValueConversionException

set_OffsetTime

public boolean set_OffsetTime(java.time.OffsetTime value,
                              boolean doTranslate)
                       throws ValueConversionException

Throws:: ValueConversionException

set_Period

public boolean set_Period(java.time.Period value,
                          boolean doTranslate)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Short

public boolean set_Short(java.lang.Short value,
                         boolean doTranslate)
                  throws ValueConversionException

Throws:: ValueConversionException

set_String

public boolean set_String(java.lang.String value,
                          boolean doTranslate)
                   throws ValueConversionException

Throws:: ValueConversionException

set_YearMonth

public boolean set_YearMonth(java.time.YearMonth value,
                             boolean doTranslate)
                      throws ValueConversionException

Throws:: ValueConversionException

set_Year

public boolean set_Year(java.time.Year value,
                        boolean doTranslate)
                 throws ValueConversionException

Throws:: ValueConversionException

set_ZonedDateTime

public boolean set_ZonedDateTime(java.time.ZonedDateTime value,
                                 boolean doTranslate)
                          throws ValueConversionException

Throws:: ValueConversionException

set_XMLDuration

public boolean set_XMLDuration(javax.xml.datatype.Duration value,
                               GProp<?> trigger)
                        throws ValueConversionException

Throws:: ValueConversionException

set_BigDecimal

public boolean set_BigDecimal(java.math.BigDecimal value,
                              GProp<?> trigger)
                       throws ValueConversionException

Throws:: ValueConversionException

set_BigInteger

public boolean set_BigInteger(java.math.BigInteger value,
                              GProp<?> trigger)
                       throws ValueConversionException

Throws:: ValueConversionException

set_Binary

public boolean set_Binary(byte[] value,
                          GProp<?> trigger)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Boolean

public boolean set_Boolean(java.lang.Boolean value,
                           GProp<?> trigger)
                    throws ValueConversionException

Throws:: ValueConversionException

set_Byte

public boolean set_Byte(java.lang.Byte value,
                        GProp<?> trigger)
                 throws ValueConversionException

Throws:: ValueConversionException

set_Double

public boolean set_Double(java.lang.Double value,
                          GProp<?> trigger)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Duration

public boolean set_Duration(java.time.Duration value,
                            GProp<?> trigger)
                     throws ValueConversionException

Throws:: ValueConversionException

set_Float

public boolean set_Float(java.lang.Float value,
                         GProp<?> trigger)
                  throws ValueConversionException

Throws:: ValueConversionException

set_Integer

public boolean set_Integer(java.lang.Integer value,
                           GProp<?> trigger)
                    throws ValueConversionException

Throws:: ValueConversionException

set_KString

public boolean set_KString(KString value,
                           GProp<?> trigger)
                    throws ValueConversionException

Throws:: ValueConversionException

set_LocalDateTime

public boolean set_LocalDateTime(java.time.LocalDateTime value,
                                 GProp<?> trigger)
                          throws ValueConversionException

Throws:: ValueConversionException

set_LocalDate

public boolean set_LocalDate(java.time.LocalDate value,
                             GProp<?> trigger)
                      throws ValueConversionException

Throws:: ValueConversionException

set_LocalTime

public boolean set_LocalTime(java.time.LocalTime value,
                             GProp<?> trigger)
                      throws ValueConversionException

Throws:: ValueConversionException

set_Long

public boolean set_Long(java.lang.Long value,
                        GProp<?> trigger)
                 throws ValueConversionException

Throws:: ValueConversionException

set_MonthDay

public boolean set_MonthDay(java.time.MonthDay value,
                            GProp<?> trigger)
                     throws ValueConversionException

Throws:: ValueConversionException

set_OffsetDateTime

public boolean set_OffsetDateTime(java.time.OffsetDateTime value,
                                  GProp<?> trigger)
                           throws ValueConversionException

Throws:: ValueConversionException

set_OffsetTime

public boolean set_OffsetTime(java.time.OffsetTime value,
                              GProp<?> trigger)
                       throws ValueConversionException

Throws:: ValueConversionException

set_Period

public boolean set_Period(java.time.Period value,
                          GProp<?> trigger)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Short

public boolean set_Short(java.lang.Short value,
                         GProp<?> trigger)
                  throws ValueConversionException

Throws:: ValueConversionException

set_String

public boolean set_String(java.lang.String value,
                          GProp<?> trigger)
                   throws ValueConversionException

Throws:: ValueConversionException

set_YearMonth

public boolean set_YearMonth(java.time.YearMonth value,
                             GProp<?> trigger)
                      throws ValueConversionException

Throws:: ValueConversionException

set_Year

public boolean set_Year(java.time.Year value,
                        GProp<?> trigger)
                 throws ValueConversionException

Throws:: ValueConversionException

set_ZonedDateTime

public boolean set_ZonedDateTime(java.time.ZonedDateTime value,
                                 GProp<?> trigger)
                          throws ValueConversionException

Throws:: ValueConversionException

set_XMLDuration

public boolean set_XMLDuration(javax.xml.datatype.Duration value,
                               boolean doTranslate,
                               GProp<?> trigger)
                        throws ValueConversionException

Throws:: ValueConversionException

set_BigDecimal

public boolean set_BigDecimal(java.math.BigDecimal value,
                              boolean doTranslate,
                              GProp<?> trigger)
                       throws ValueConversionException

Throws:: ValueConversionException

set_BigInteger

public boolean set_BigInteger(java.math.BigInteger value,
                              boolean doTranslate,
                              GProp<?> trigger)
                       throws ValueConversionException

Throws:: ValueConversionException

set_Binary

public boolean set_Binary(byte[] value,
                          boolean doTranslate,
                          GProp<?> trigger)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Boolean

public boolean set_Boolean(java.lang.Boolean value,
                           boolean doTranslate,
                           GProp<?> trigger)
                    throws ValueConversionException

Throws:: ValueConversionException

set_Byte

public boolean set_Byte(java.lang.Byte value,
                        boolean doTranslate,
                        GProp<?> trigger)
                 throws ValueConversionException

Throws:: ValueConversionException

set_Double

public boolean set_Double(java.lang.Double value,
                          boolean doTranslate,
                          GProp<?> trigger)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Duration

public boolean set_Duration(java.time.Duration value,
                            boolean doTranslate,
                            GProp<?> trigger)
                     throws ValueConversionException

Throws:: ValueConversionException

set_Float

public boolean set_Float(java.lang.Float value,
                         boolean doTranslate,
                         GProp<?> trigger)
                  throws ValueConversionException

Throws:: ValueConversionException

set_Integer

public boolean set_Integer(java.lang.Integer value,
                           boolean doTranslate,
                           GProp<?> trigger)
                    throws ValueConversionException

Throws:: ValueConversionException

set_KString

public boolean set_KString(KString value,
                           boolean doTranslate,
                           GProp<?> trigger)
                    throws ValueConversionException

Throws:: ValueConversionException

set_LocalDateTime

public boolean set_LocalDateTime(java.time.LocalDateTime value,
                                 boolean doTranslate,
                                 GProp<?> trigger)
                          throws ValueConversionException

Throws:: ValueConversionException

set_LocalDate

public boolean set_LocalDate(java.time.LocalDate value,
                             boolean doTranslate,
                             GProp<?> trigger)
                      throws ValueConversionException

Throws:: ValueConversionException

set_LocalTime

public boolean set_LocalTime(java.time.LocalTime value,
                             boolean doTranslate,
                             GProp<?> trigger)
                      throws ValueConversionException

Throws:: ValueConversionException

set_Long

public boolean set_Long(java.lang.Long value,
                        boolean doTranslate,
                        GProp<?> trigger)
                 throws ValueConversionException

Throws:: ValueConversionException

set_MonthDay

public boolean set_MonthDay(java.time.MonthDay value,
                            boolean doTranslate,
                            GProp<?> trigger)
                     throws ValueConversionException

Throws:: ValueConversionException

set_OffsetDateTime

public boolean set_OffsetDateTime(java.time.OffsetDateTime value,
                                  boolean doTranslate,
                                  GProp<?> trigger)
                           throws ValueConversionException

Throws:: ValueConversionException

set_OffsetTime

public boolean set_OffsetTime(java.time.OffsetTime value,
                              boolean doTranslate,
                              GProp<?> trigger)
                       throws ValueConversionException

Throws:: ValueConversionException

set_Period

public boolean set_Period(java.time.Period value,
                          boolean doTranslate,
                          GProp<?> trigger)
                   throws ValueConversionException

Throws:: ValueConversionException

set_Short

public boolean set_Short(java.lang.Short value,
                         boolean doTranslate,
                         GProp<?> trigger)
                  throws ValueConversionException

Throws:: ValueConversionException

set_String

public boolean set_String(java.lang.String value,
                          boolean doTranslate,
                          GProp<?> trigger)
                   throws ValueConversionException

Throws:: ValueConversionException

set_YearMonth

public boolean set_YearMonth(java.time.YearMonth value,
                             boolean doTranslate,
                             GProp<?> trigger)
                      throws ValueConversionException

Throws:: ValueConversionException

set_Year

public boolean set_Year(java.time.Year value,
                        boolean doTranslate,
                        GProp<?> trigger)
                 throws ValueConversionException

Throws:: ValueConversionException

set_ZonedDateTime

public boolean set_ZonedDateTime(java.time.ZonedDateTime value,
                                 boolean doTranslate,
                                 GProp<?> trigger)
                          throws ValueConversionException

Throws:: ValueConversionException

setValue
```
public boolean setValue(java.lang.Object value,
                        boolean doTranslate)
                 throws ValueConversionException
```
Sets a value in generic type with possible translation and no trigger property.
Parameters:
value - The value in any of the Value type value classes.
doTranslate - Translate the value using the field actors.
Returns:
true if the value is set, false for no change.
Throws:
java.lang.IllegalArgumentException - If the value is not of correct class.
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

setValue
```
public boolean setValue(java.lang.Object value,
                        boolean doTranslate,
                        GProp<?> trigger)
                 throws ValueConversionException
```
Sets a value in generic type with possible translation and optional trigger property.
Parameters:
value - The value in any of the Value type value classes.
doTranslate - Translate the value using the field actors.
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
true if the value is set, false for no change.
Throws:
java.lang.IllegalArgumentException - If the value is not of correct class.
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

setValue
```
public boolean setValue(LocaleInfo localeInfo,
                        java.lang.Object value,
                        boolean doTranslate,
                        GProp<?> trigger)
                 throws ValueConversionException
```
Sets a value in generic type with possible translation and optional trigger property.
Parameters:
localeInfo - The locale info or null for default.
value - The value in any of the Value type value classes.
doTranslate - Translate the value using the field actors.
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
Returns:
true if the value is set, false for no change.
Throws:
java.lang.IllegalArgumentException - If the value is not of correct class.
ValueConversionException - If a field actor throws the exception, or the value cannot be converted.

adjustValue
```
public Value adjustValue(java.time.temporal.TemporalAdjuster temporalAdjuster,
                         GProp<?> trigger)
                  throws ValueConversionException
```
Adjusts the current temporal value with a temporal adjuster.
The current value type must be of one of the supported types:
- LocalTime,
- OffsetTime,
- LocalDate,
- MonthDay,
- Year,
- YearMonth,
- LocalDateTime,
- OffsetDateTime or
- ZonedDateTime,
otherwise ValueConversionException is thrown.
This method makes it possible to update e.g. a LocalDateTime with a LocalTime, returning a new LocalDateTime Value with the same LocalDate, but with the new LocalTime.
Parameters:
temporalAdjuster - The temporal used to adjust with.
trigger - The triggering component (e.g. UIDateTime), or null for none.
Returns:
The new Value set.
Throws:
ValueConversionException - If value conversion problems occurs, such as numeric overflow, invalid adjustment, etc, or if the value type is not of correct type.

adjustValue
```
public Value adjustValue(java.time.ZoneId zoneID,
                         GProp<?> trigger)
                  throws ValueConversionException
```
Adjusts the current ZonedDateTime value with a new Zone ID. The new ZonedDateTime is created with the same Local Date and Time but with another Zone ID (and not at the same Instant).
Note: the value type MUST be ZonedDateTime, otherwise ValueConversionException is thrown!
Parameters:
zoneID - The zone ID to adjust with.
trigger - The triggering component (e.g. UIDateTime), or null for none.
Returns:
The new Value set.
Throws:
ValueConversionException - If value conversion problems occurs, such as current value is null, numeric overflow, etc, or if the value type is not of correct type.

convertEqualsValue
```
public int convertEqualsValue(GProp<?> trigger,
                              Value... values)
```
Verifies if a value could potentially be equal to the value in the field using conversion. This method is typically used for components matching a state. The values are compared by converting the value in this field to the requested value type (if required). The comparison of the values is then done.
Parameters:
trigger - The trigger property, i.e. the "requestor of this method", can be null for none. This value gives extra information for the VSFieldEvent and is not processed in the framework.
values - The value to compare with.
Returns:
true The index of the value matching, -1 for none. Logging is done if conversion fails.

paramValue
```
protected java.lang.String paramValue(java.lang.Object value)
```
Formats the value as a string to add to paramString.
Overrides:
paramValue in class GProp<GProp<?>[]>
Returns:
A string containing all children properties listed.

Class VSField

Nested Class Summary

Nested classes/interfaces inherited from interface com.iizix.gyro.IMessageBox

Nested classes/interfaces inherited from interface com.iizix.prop.vs.IVSComponentState

Field Summary

Fields inherited from class com.iizix.prop.vs.VSComponent

Fields inherited from class com.iizix.prop.PropCnr

Fields inherited from class com.iizix.prop.GProp

Fields inherited from interface com.iizix.prop.IGProp

Fields inherited from interface com.iizix.gyro.IMessageBox

Fields inherited from interface com.iizix.prop.vs.IVSComponent

Constructor Summary

Method Summary

Methods inherited from class com.iizix.prop.vs.VSComponent

Methods inherited from class com.iizix.prop.PropCnr

Methods inherited from class com.iizix.prop.GProp

Methods inherited from class java.lang.Object

Methods inherited from interface com.iizix.prop.ICustomDataProvider

Methods inherited from interface com.iizix.gyro.IFocusComp

Methods inherited from interface com.iizix.prop.IGProp

Methods inherited from interface com.iizix.gyro.IMessageBox

Methods inherited from interface com.iizix.prop.IPropCnr

Methods inherited from interface com.iizix.prop.vs.IVSComponent

Methods inherited from interface com.iizix.prop.vs.IVSMessageComponent

Field Detail

EMPTY_LISTENERS

Constructor Detail

VSField

VSField

Method Detail

clone

getValueType

getValueTypeString

getComponentIsHidden

getComponentIsDisabled

isTableCell

getTable

getColumnIndex

getRowIndex

getColumn

getRows

getRow

onEventSelf

onParentStateChanged

createFieldActors

getActors

addPredefinedProps

getPredefinedProps

addListener

removeListener

onListenerChanged

getFieldListeners

setNullAllowed

setNullAllowed

isNullAllowed

setRawValue

setRawValue

getRawValue

getRawValueType

isNull

assignAcceptableValue

setPattern

setPattern

getPatternProp

getPattern

getPatternPlainKString

setValue

get_StringRaw

get_String

get_String

get_String

get_String

get_String

get_String

get_String

get_String

getLocaleInfo

getLocaleInfo

get_KString

get_KString