:: 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 ::com::sun::star::form::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 ::com::sun::star::form::FormController may contain one or more other ::com::sun::star::form::FormController s, so the form model structure or hierarchy is reflected in the structure of ::com::sun::star::form::FormController s.

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

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

Included Services
::com::sun::star::form::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
::com::sun::star::form::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.
::com::sun::star::form::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 ::com::sun::star::form::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.
::com::sun::star::form::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 ::com::sun::star::form::XDatabaseParameterListener is registered at the controller, it uses an own dialog to ask the user for parameter values.


 
Top of Page