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

service CommandButton
Description
describes a button control.

The model of the control has to support the ::com::sun::star::form::component::CommandButton service.

The control is clickable, the action taken upon clicking depends on the settings of the model the control belongs to.

See also
::com::sun::star::awt::UnoControl, ::com::sun::star::awt::UnoControlModel, ::com::sun::star::form::component::CommandButton::ButtonType

Included Services - Summary
::com::sun::star::awt::UnoControlButton
(referenced entity's summary:)
specifies a button control.
Exported Interfaces - Summary
::com::sun::star::form::XApproveActionBroadcaster

allows external instances to register as veto listener for the button's actions. (details)

Included Services - Details
::com::sun::star::awt::UnoControlButton
(referenced entity's summary:)
specifies a button control.
Exported Interfaces - Details
::com::sun::star::form::XApproveActionBroadcaster
Description
allows external instances to register as veto listener for the button's actions.

An ::com::sun::star::form::XApproveActionListener returning false on it's approve-method will prevent any action which would usually be triggered - this includes not only submitting or resetting forms, but also calling the ::com::sun::star::awt::XActionListeners of the super service
This may be interesting for e.g. forms which want to provide input validation before submitting data.

See also
::com::sun::star::form::component::HTMLForm, ::com::sun::star::form::XSubmit, ::com::sun::star::form::XReset, ::com::sun::star::awt::XButton

 
Top of Page