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

service ImageButton
Description
describes a control which can be used for displaying images on a control acting like a button.

The model of the control has to support the ::com::sun::star::form::component::ImageButton 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::ImageButton::ButtonType

Included Services - Summary
::com::sun::star::awt::UnoControlImageControl
(referenced entity's summary:)
specifies a control for displaying an image.
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::UnoControlImageControl
(referenced entity's summary:)
specifies a control for displaying an image.
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