Package com.partnersoft.gui.forms

Data-aware, schema-driven GUI forms framework.

See:
Description

Interface Summary

FormField<T>	A data-entry field on a Form.
FormFieldListener	Listener for FormFieldEvents.

Class Summary

AbstractFormField<T>	Starter implementation of FormField.
AbstractFormTextField<T>	A FormField for single-line entry of values that can be represented as a text primitive.
Form	A Form is a classic form-like GUI editor for data.
FormBuilder	A schema- and Forms-aware GUI building tool.
FormButton	A button.
FormCheckboxField	A wrapper for JCheckBox.
FormCogFilterField	Multi-Component field for defining a DataFilterExpression for a given CogStructureField.
FormColorField	A basic convenience wrapper around a JColorChooser.
FormComboField	A Field implemented with a JComboBox.
FormDatabaseField	Copyright 2010 Partner Software, Inc.
FormDateAndTimeDocument	A document that only allows dateTime values.
FormDateAndTimeField	A FormField that modifies com.partnersoft.data.DateAndTime objects.
FormDateDocument	A document that only allows date values.
FormDateField	A FormField that modifies com.partnersoft.data.Date objects.
FormDialog	Dialog window for a GUIForm.
FormDirectionField	A FormField to specify angular direction.
FormDurationDocument	A document that only allows dateTime values.
FormDurationField	A FormField that modifies com.partnersoft.data.Duration objects.
FormFieldEvent<T>	A value change or "action" event triggered by a FormField.
FormFilePathField	A GUIField for entering a file name.
FormFilePathListField	A GUIField for entering a file name.
FormIconField	An icon-selection field.
FormIconPicklistField	A FormField implemented with a JComboBox containing icons.
FormIntegerDocument	A document that only allows integral values.
FormIntegerField	A type-in field that only accepts Integers.
FormLimitedLengthDocument<T>	A document that only allows strings up to a certain size.
FormNamedBlobField	Field for editing a NamedBlob - which is generally a file that's stored in a database or some such instead of a filesystem.
FormNumberDocument	A document that only allows numeric values.
FormNumberField	A type-in field that only accepts floating point numbers.
FormPanel	Sets up a panel with a form layout.
FormPasswordField	A string field that doesn't display what you're typing, for security purposes when entering passwords etc.
FormPicklistField	A FormField implemented with a JComboBox.
FormRandomIntegerField	A type-in field that only accepts Integers.
FormReadOnlyStringField	A read-only string label filled in with data in a Form, but not editable.
FormStringField	A FormField for single-line text entry.
FormTextField	A FormField that allows you to modify multi-lined text.
FormTimeDocument	A document that only allows time values.
FormTimeField	A FormField that modifies com.partnersoft.data.Date objects.
FormValidatedDocument<T>	This class extends the PlainDocument class in order to provide field level validation of the String being built.

Package com.partnersoft.gui.forms Description

Data-aware, schema-driven GUI forms framework.

Partner Forms is an attempt to accommodate both simple, script-driven forms and more complex, data- and schema-aware forms. It provides convenience methods and auto-generation based on configuration rather than code.

To accommodate more complex tasks, it also provides low-level access to underlying Swing containers and components. Developers can therefore use a mixture of auto-generated styles and hand-coded styles.

The data layer can be represented with either a simple Naming or an arbitrarily complex CogHeader structure.

There are two major concepts introduced, Form and FormField. A Form is a collection of FormFields placed in a layout with other containers and components. The Form handles events and the data layer. A FormField is an individual control like a checkbox, picklist, or text box, which is tied to a named value in the data layer. FormFields have a simpler and more consistent data-handling and event mechanism than the Swing controls typically used, but you can always access the underlying components if you need to tweak them in some specific fashion.

Forms are constructed using FormBuilder, which provides a simple API that doesn't require you to track intermediate objects or import tons of Swing classes. FormBuilder has powerful convenience methods to auto-generate a form and basic layout using CogSchema settings.

Copyright 2009 Partner Software, Inc.

Version:

$Id$

Author:

Paul Reavis, Rich Stepanski