:: com :: sun :: star :: form ::

service FormController
Description
specifies a component controlling the interaction between the user and form functionality.

As soon as a form (containing controls) is to be presented to the user, there is a need for an instance controlling the user interaction.
Such a FormController is responsible for dialog processing, like controlling the tab order and the grouping of controls.

As a form may contain one or many subforms, a FormController may contain one or more other FormController s, so the form model structure or hierarchy is reflected in the structure of FormController s.

A FormController is responsible for a ::com::sun::star::awt::UnoControlContainer , and all controls therein.

See also
::com::sun::star::form::component, ::com::sun::star::awt::XTabController

Included Services
FormControllerDispatcher
Usage Restrictions
optional
Description
allows delegating form controller functionality to the component

If a control which the controller is responsible for supports the ::com::sun::star::frame::XDispatchProviderInterception interface, the controller registers a dispatch interceptor. Then, the control can try to delegate part of its functionality to the controller by querying the dispatch interceptor for it.

Exported Interfaces
XFormController
Description
is used for notifying the (de)activation of the controller.
::com::sun::star::awt::XTabController
Description
is used for tab controlling and grouping of the controls.
::com::sun::star::container::XChild
Description
A FormController may have a parent controller, such as when the related form is a subform.
::com::sun::star::lang::XComponent
Description
A FormController must be disposable.
::com::sun::star::container::XEnumerationAccess
Description
A FormController must provide access to its sub controllers.
::com::sun::star::util::XModifyBroadcaster
Description
A FormController must communicate if any of its children (means sub controllers) or contained controls have been modified.
XConfirmDeleteBroadcaster
Description
used to notify deletions of data in the form before they happen.

A form controller listens for deletion events at the form it is responsible for.
If and only if no XConfirmDeleteListener is registered at the controller, it uses an own dialog to ask the user for confirmation.

You may use this interface to integrate your own confirmation dialogs.

::com::sun::star::sdb::XSQLErrorBroadcaster
Description
used to notify errors which happen in the form the controller is responsible for.

A form controller listens for error events at the form it is responsible for.
If and only if no ::com::sun::star::sdb::XSQLErrorListener is registered at the controller, it uses an own dialog to notify the user of the error.

::com::sun::star::sdb::XRowSetApproveBroadcaster
Description
is used for multiplexing row set events happening on the form which the controller is responsible for.
XDatabaseParameterBroadcaster
Description
is used broadcasting parameter events in the form.

A form controller listens for parameter events at the form it is responsible for.
If and only if no XDatabaseParameterListener is registered at the controller, it uses an own dialog to ask the user for parameter values.


 
Top of Page