:: com :: sun :: star :: form :: control ::
|
unpublished |
service SubmitButton |
|
|
- Usage Restrictions
- not published
- Description
- specifies a button control which can execute external submissions
The model of the control has to support the ::com::sun::star::form::component::SubmitButton
service.
The control is clickable. When clicked (by mouse or keyboard, or programmatically),
the following happens:
- Any ::com::sun::star::form::submission::XSubmissionVetoListeners registered
at the component are given the chance to veto the submission.
- The model of the control is examined for an external submission object. That is,
::com::sun::star::form::submission::XSubmissionSupplier::getSubmission
is called at the model.
If there is such a submission object, its
::com::sun::star::form::submission::XSubmission::submit method is invoked.
- If there is no external submission, the parent object of the model is examined
for the presence of the ::com::sun::star::form::XSubmit interface. If it
is present, it's ::com::sun::star::form::XSubmit::submit method is
invoked.
Since the parent object of a submit button can only be a ::com::sun::star::form::component::Form,
this means that SubmitButtons are also able to submit ::com::sun::star::form::component::HTMLForms.
|
Exported Interfaces - Summary |
::com::sun::star::form::submission::XSubmission |
allows interception (and vetoing) of submissions triggered by the control.
|
Top of Page
Copyright © 2012, The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache, the Apache feather logo, Apache OpenOffice and OpenOffice.org are trademarks of The Apache Software Foundation. Other names may be trademarks of their respective owners.