Interface FormContextListener


  • public interface FormContextListener

    An event listener interface to be implemented by components that are interested in the creation of new form contexts during a builder operation.

    Some complex components (e.g. tables) require the creation of sub forms during their construction. Typically, such sub forms require special treatment. Therefore, it may be important for affected components (like a concrete ComponentManager implementation) to receive a notification when a form context is created or closed. This interface defines a set of callback methods allowing such notifications to be passed.

    Objects implementing this interface can register themselves at a ComponentBuilderData object. They are then notified about changes of the current form context during a builder operation.

    Since:
    1.3
    Version:
    $Id$
    Author:
    Oliver Heger
    • Method Detail

      • formContextCreated

        void formContextCreated​(Form form,
                                Object source)
        Notifies this object that a new form context was created. This new form context becomes the current context; so all newly created components are added to this form. The source object responsible for the context creation is also passed to this method - it may be null if no information about the source is available. In most cases, this source will be a tag.
        Parameters:
        form - the Form object associated with the new context
        source - the source which created the new form context (if known)
      • formContextClosed

        void formContextClosed​(Form form,
                               Object source)
        Notifies this object that the current form context was closed. Each call to formContextCreated(Form, Object) is followed eventually by an invocation of this method.
        Parameters:
        form - the Form object associated with the new context
        source - the source responsible for this form context (if known)