'Declaration

Public Property value As System.Object

public System.Object value { get; set; }

public: __property System.Object get_value();
public: __property void set_value(
   System.Object value
);

public:
property System.Object value {
   System.Object get();
   void set(System.Object value);
}

This property has different meanings for different field events:

• For the Field/Validate event, it is the value that the field contains when it is committed. For a combo box, it is the face value, not the export value (see changeEx).
• For a Field/Calculate event, JavaScript should set this property. It is the value that the field should take upon completion of the event.
• For a Field/Format event, JavaScript should set this property. It is the value used when generating the appearance for the field. By default, it contains the value that the user has committed. For a combo box, this is the face value, not the export value (see changeEx for the export value).
• For a Field/Keystroke event, it is the current value of the field. If modifying a text field, for example, this is the text in the text field before the keystroke is applied.
• For Field/Blur and Field/Focus events, it is the current value of the field. During these two events, event.value is read only. That is, the field value cannot be changed by setting event.value.

Beginning with Acrobat 5.0, for a list box that allows multiple selections (see field.multipleSelection), the following behavior occurs. If the field value is an array (that is, multiple items are selected), event.value returns an empty string when getting, and does not accept setting.