com.sage.accpac.sm
Class FieldChangeEvent

java.lang.Object
  extended by java.util.EventObject
      extended by com.sage.accpac.sm.FieldChangeEvent
All Implemented Interfaces:
java.io.Serializable

@Immutable
@ThreadSafe
public class FieldChangeEvent
extends java.util.EventObject

Contains the details of a field change notification.

The notification event's View can be retrieved by obtaining the event's source using getSource().

Use getFieldID() to see which field generated this event.

If this is associated with a field attribute change then call isEditable(), isEnabled(), #isInKey() and isRequired() to see what the new values are for these dynamic attributes.

See Also:
NotificationListener, NotificationListener.fieldValueChanged(FieldChangeEvent), NotificationListener.fieldPresentationChanged(FieldChangeEvent), NotificationListener.fieldAttributesChanged(FieldChangeEvent), Serialized Form
Thread safety
Immutable and therefore thread-safe

Field Summary
 
Fields inherited from class java.util.EventObject
source
 
Method Summary
 int getFieldID()
          Get the view field ID of the field that is changing.
 boolean isEditable()
          returns true if and only if the value can be changed by the caller.
 boolean isEnabled()
          returns true if and only if the field can be meaningfully used.
 boolean isRequired()
          returns true if and only if the value must be changed interactively before the record can be inserted.
 
Methods inherited from class java.util.EventObject
getSource, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Method Detail

getFieldID

public int getFieldID()
Get the view field ID of the field that is changing.

See Also:
ViewFields.get(int)

isEditable

public boolean isEditable()
returns true if and only if the value can be changed by the caller.

If ViewField.mustCheckEditable() is true then this property can change but if it returns false then the property will remain the same.

See Also:
ViewField.mustCheckEditable(), ViewField.isEditable()

isEnabled

public boolean isEnabled()
returns true if and only if the field can be meaningfully used.

If this returns false most field operations are not permitted and will result in an exception being thrown.

See Also:
ViewField.isEnabled()

isRequired

public boolean isRequired()
returns true if and only if the value must be changed interactively before the record can be inserted.

See Also:
ViewField.isRequired()


Copyright © 2010 Sage Software, Inc. All rights reserved.