Class VSField

Method Details

• 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 String getValueTypeString()

  Gets the value type string.

  Returns:

  The field type as Value.T_* or "<undefined>" for none.

• getComponentIsHidden

  public String getComponentIsHidden()

  Gets the focus message for "Component is hidden" but for the component in question.

  Specified by:

  getComponentIsHidden in class VSComponent

• getComponentIsDisabled

  public String getComponentIsDisabled()

  Gets the focus message for "Component is disabled" but for the component in question.

  Specified by:

  getComponentIsDisabled in class VSComponent

• getReferenceType

  public IPropReference.IRefType getReferenceType()

  Gets the reference Type.

  Specified by:

  getReferenceType in interface IReferencingPropCnr

  Returns:

  IPropReference.RefType.VSField.

• usesMultipleReferencing

  public boolean usesMultipleReferencing()

  Checks if this referencing Property Container has single or multiple referencing properties at maximum.

  Specified by:

  usesMultipleReferencing in interface IReferencingPropCnr

  Returns:

  Always false as only a single referencing property is supported. Use the method getReferencingProp() to retrieve it.

• getReferencingProp

  public IReferencingGProp getReferencingProp()

  Gets the single potential instance of a referencing property instance.

  Specified by:

  getReferencingProp in interface IReferencingPropCnr

  Returns:

  The single referencing property, or null if none is found.

• getReferencingProps

  public IReferencingGProp[] getReferencingProps()

  Gets the array of referencing property instances.

  Specified by:

  getReferencingProps in interface IReferencingPropCnr

  Returns:

  Always null as there is only support for a single referencing property. Use the method getReferencingProp() to retrieve it.

• 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:

  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:

  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 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(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 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 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 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 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 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 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 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 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 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 Duration get_XMLDuration() throws ValueConversionException

  Throws:

  ValueConversionException

• get_BigDecimal

  public BigDecimal get_BigDecimal() throws ValueConversionException

  Throws:

  ValueConversionException

• get_BigInteger

  public BigInteger get_BigInteger() throws ValueConversionException

  Throws:

  ValueConversionException

• get_Binary

  public byte[] get_Binary() throws ValueConversionException

  Throws:

  ValueConversionException

• get_Boolean

  public Boolean get_Boolean() throws ValueConversionException

  Throws:

  ValueConversionException

• get_Byte

  public Byte get_Byte() throws ValueConversionException

  Throws:

  ValueConversionException

• get_Double

  public Double get_Double() throws ValueConversionException

  Throws:

  ValueConversionException

• get_Duration

  public Duration get_Duration() throws ValueConversionException

  Throws:

  ValueConversionException

• get_Float

  public Float get_Float() throws ValueConversionException

  Throws:

  ValueConversionException

• get_Integer

  public Integer get_Integer() throws ValueConversionException

  Throws:

  ValueConversionException

• get_LocalDateTime

  public LocalDateTime get_LocalDateTime() throws ValueConversionException

  Throws:

  ValueConversionException

• get_LocalDate

  public LocalDate get_LocalDate() throws ValueConversionException

  Throws:

  ValueConversionException

• get_LocalTime

  public LocalTime get_LocalTime() throws ValueConversionException

  Throws:

  ValueConversionException

• get_Long

  public Long get_Long() throws ValueConversionException

  Throws:

  ValueConversionException

• get_MonthDay

  public MonthDay get_MonthDay() throws ValueConversionException

  Throws:

  ValueConversionException

• get_OffsetDateTime

  public OffsetDateTime get_OffsetDateTime() throws ValueConversionException

  Throws:

  ValueConversionException

• get_OffsetTime

  public OffsetTime get_OffsetTime() throws ValueConversionException

  Throws:

  ValueConversionException

• get_Period

  public Period get_Period() throws ValueConversionException

  Throws:

  ValueConversionException

• get_Short

  public Short get_Short() throws ValueConversionException

  Throws:

  ValueConversionException

• get_YearMonth

  public YearMonth get_YearMonth() throws ValueConversionException

  Throws:

  ValueConversionException

• get_Year

  public Year get_Year() throws ValueConversionException

  Throws:

  ValueConversionException

• get_ZonedDateTime

  public ZonedDateTime get_ZonedDateTime() throws ValueConversionException

  Throws:

  ValueConversionException

• get_XMLDuration

  public Duration get_XMLDuration(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_BigDecimal

  public BigDecimal get_BigDecimal(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_BigInteger

  public BigInteger get_BigInteger(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Binary

  public byte[] get_Binary(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Boolean

  public Boolean get_Boolean(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Byte

  public Byte get_Byte(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Double

  public Double get_Double(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Duration

  public Duration get_Duration(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Float

  public Float get_Float(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Integer

  public Integer get_Integer(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_LocalDateTime

  public LocalDateTime get_LocalDateTime(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_LocalDate

  public LocalDate get_LocalDate(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_LocalTime

  public LocalTime get_LocalTime(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Long

  public Long get_Long(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_MonthDay

  public MonthDay get_MonthDay(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_OffsetDateTime

  public OffsetDateTime get_OffsetDateTime(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_OffsetTime

  public OffsetTime get_OffsetTime(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Period

  public Period get_Period(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Short

  public Short get_Short(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_YearMonth

  public YearMonth get_YearMonth(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Year

  public Year get_Year(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_ZonedDateTime

  public ZonedDateTime get_ZonedDateTime(boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• get_XMLDuration

  public Duration get_XMLDuration(GProp<?> trigger) throws ValueConversionException

  Throws:

  ValueConversionException

• get_BigDecimal

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

  Throws:

  ValueConversionException

• get_BigInteger

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

  Throws:

  ValueConversionException

• get_Binary

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

  Throws:

  ValueConversionException

• get_Boolean

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

  Throws:

  ValueConversionException

• get_Byte

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

  Throws:

  ValueConversionException

• get_Double

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

  Throws:

  ValueConversionException

• get_Duration

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

  Throws:

  ValueConversionException

• get_Float

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

  Throws:

  ValueConversionException

• get_Integer

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

  Throws:

  ValueConversionException

• get_LocalDateTime

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

  Throws:

  ValueConversionException

• get_LocalDate

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

  Throws:

  ValueConversionException

• get_LocalTime

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

  Throws:

  ValueConversionException

• get_Long

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

  Throws:

  ValueConversionException

• get_MonthDay

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

  Throws:

  ValueConversionException

• get_OffsetDateTime

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

  Throws:

  ValueConversionException

• get_OffsetTime

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

  Throws:

  ValueConversionException

• get_Period

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

  Throws:

  ValueConversionException

• get_Short

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

  Throws:

  ValueConversionException

• get_YearMonth

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

  Throws:

  ValueConversionException

• get_Year

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

  Throws:

  ValueConversionException

• get_ZonedDateTime

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

  Throws:

  ValueConversionException

• get_XMLDuration

  public Duration get_XMLDuration(boolean doTranslate, GProp<?> trigger) throws ValueConversionException

  Throws:

  ValueConversionException

• get_BigDecimal

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

  Throws:

  ValueConversionException

• get_BigInteger

  public 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 Boolean get_Boolean(boolean doTranslate, GProp<?> trigger) throws ValueConversionException

  Throws:

  ValueConversionException

• get_Byte

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

  Throws:

  ValueConversionException

• get_Double

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

  Throws:

  ValueConversionException

• get_Duration

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

  Throws:

  ValueConversionException

• get_Float

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

  Throws:

  ValueConversionException

• get_Integer

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

  Throws:

  ValueConversionException

• get_LocalDateTime

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

  Throws:

  ValueConversionException

• get_LocalDate

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

  Throws:

  ValueConversionException

• get_LocalTime

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

  Throws:

  ValueConversionException

• get_Long

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

  Throws:

  ValueConversionException

• get_MonthDay

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

  Throws:

  ValueConversionException

• get_OffsetDateTime

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

  Throws:

  ValueConversionException

• get_OffsetTime

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

  Throws:

  ValueConversionException

• get_Period

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

  Throws:

  ValueConversionException

• get_Short

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

  Throws:

  ValueConversionException

• get_YearMonth

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

  Throws:

  ValueConversionException

• get_Year

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

  Throws:

  ValueConversionException

• get_ZonedDateTime

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

  Throws:

  ValueConversionException

• getValue

  public 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 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 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 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(Duration value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_BigDecimal

  public boolean set_BigDecimal(BigDecimal value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_BigInteger

  public boolean set_BigInteger(BigInteger value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Binary

  public boolean set_Binary(byte[] value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Boolean

  public boolean set_Boolean(Boolean value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Byte

  public boolean set_Byte(Byte value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Double

  public boolean set_Double(Double value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Duration

  public boolean set_Duration(Duration value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Float

  public boolean set_Float(Float value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Integer

  public boolean set_Integer(Integer value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_KString

  public boolean set_KString(KString value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_LocalDateTime

  public boolean set_LocalDateTime(LocalDateTime value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_LocalDate

  public boolean set_LocalDate(LocalDate value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_LocalTime

  public boolean set_LocalTime(LocalTime value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Long

  public boolean set_Long(Long value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_MonthDay

  public boolean set_MonthDay(MonthDay value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_OffsetDateTime

  public boolean set_OffsetDateTime(OffsetDateTime value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_OffsetTime

  public boolean set_OffsetTime(OffsetTime value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Period

  public boolean set_Period(Period value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Short

  public boolean set_Short(Short value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_String

  public boolean set_String(String value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_YearMonth

  public boolean set_YearMonth(YearMonth value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Year

  public boolean set_Year(Year value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_ZonedDateTime

  public boolean set_ZonedDateTime(ZonedDateTime value) throws ValueConversionException

  Throws:

  ValueConversionException

• set_XMLDuration

  public boolean set_XMLDuration(Duration value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_BigDecimal

  public boolean set_BigDecimal(BigDecimal value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_BigInteger

  public boolean set_BigInteger(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(Boolean value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Byte

  public boolean set_Byte(Byte value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Double

  public boolean set_Double(Double value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Duration

  public boolean set_Duration(Duration value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Float

  public boolean set_Float(Float value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Integer

  public boolean set_Integer(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(LocalDateTime value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_LocalDate

  public boolean set_LocalDate(LocalDate value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_LocalTime

  public boolean set_LocalTime(LocalTime value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Long

  public boolean set_Long(Long value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_MonthDay

  public boolean set_MonthDay(MonthDay value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_OffsetDateTime

  public boolean set_OffsetDateTime(OffsetDateTime value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_OffsetTime

  public boolean set_OffsetTime(OffsetTime value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Period

  public boolean set_Period(Period value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Short

  public boolean set_Short(Short value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_String

  public boolean set_String(String value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_YearMonth

  public boolean set_YearMonth(YearMonth value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Year

  public boolean set_Year(Year value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_ZonedDateTime

  public boolean set_ZonedDateTime(ZonedDateTime value, boolean doTranslate) throws ValueConversionException

  Throws:

  ValueConversionException

• set_XMLDuration

  public boolean set_XMLDuration(Duration value, GProp<?> trigger) throws ValueConversionException

  Throws:

  ValueConversionException

• set_BigDecimal

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

  Throws:

  ValueConversionException

• set_BigInteger

  public boolean set_BigInteger(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(Boolean value, GProp<?> trigger) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Byte

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

  Throws:

  ValueConversionException

• set_Double

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

  Throws:

  ValueConversionException

• set_Duration

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

  Throws:

  ValueConversionException

• set_Float

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

  Throws:

  ValueConversionException

• set_Integer

  public boolean set_Integer(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(LocalDateTime value, GProp<?> trigger) throws ValueConversionException

  Throws:

  ValueConversionException

• set_LocalDate

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

  Throws:

  ValueConversionException

• set_LocalTime

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

  Throws:

  ValueConversionException

• set_Long

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

  Throws:

  ValueConversionException

• set_MonthDay

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

  Throws:

  ValueConversionException

• set_OffsetDateTime

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

  Throws:

  ValueConversionException

• set_OffsetTime

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

  Throws:

  ValueConversionException

• set_Period

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

  Throws:

  ValueConversionException

• set_Short

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

  Throws:

  ValueConversionException

• set_String

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

  Throws:

  ValueConversionException

• set_YearMonth

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

  Throws:

  ValueConversionException

• set_Year

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

  Throws:

  ValueConversionException

• set_ZonedDateTime

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

  Throws:

  ValueConversionException

• set_XMLDuration

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

  Throws:

  ValueConversionException

• set_BigDecimal

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

  Throws:

  ValueConversionException

• set_BigInteger

  public boolean set_BigInteger(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(Boolean value, boolean doTranslate, GProp<?> trigger) throws ValueConversionException

  Throws:

  ValueConversionException

• set_Byte

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

  Throws:

  ValueConversionException

• set_Double

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

  Throws:

  ValueConversionException

• set_Duration

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

  Throws:

  ValueConversionException

• set_Float

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

  Throws:

  ValueConversionException

• set_Integer

  public boolean set_Integer(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(LocalDateTime value, boolean doTranslate, GProp<?> trigger) throws ValueConversionException

  Throws:

  ValueConversionException

• set_LocalDate

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

  Throws:

  ValueConversionException

• set_LocalTime

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

  Throws:

  ValueConversionException

• set_Long

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

  Throws:

  ValueConversionException

• set_MonthDay

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

  Throws:

  ValueConversionException

• set_OffsetDateTime

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

  Throws:

  ValueConversionException

• set_OffsetTime

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

  Throws:

  ValueConversionException

• set_Period

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

  Throws:

  ValueConversionException

• set_Short

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

  Throws:

  ValueConversionException

• set_String

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

  Throws:

  ValueConversionException

• set_YearMonth

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

  Throws:

  ValueConversionException

• set_Year

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

  Throws:

  ValueConversionException

• set_ZonedDateTime

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

  Throws:

  ValueConversionException

• setValue

  public boolean setValue(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:

  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(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:

  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, 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:

  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(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(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 String paramValue(Object value)

  Formats the value as a string to add to paramString.

  Overrides:

  paramValue in class GProp<GProp<?>[]>

  Parameters:

  value - The property value.

  Returns:

  A string containing all children properties listed.