itp:button element

<itp:button

	id=

>

	<xforms:submit/>

	( <itp:layout-hint/> )?

</itp:button>

Description

The <itp:button> element specifies a button that appears on the form. These buttons are used to submit the content back to the server.

Attributes

id	Identification of the button.

Content

The <itp:button> element defines an XForms submit element which is used to submit the form back to the server. This <xforms:submit> element has an submission= attribute whose value is ultimately passed to the COM API as the action parameter.

<itp:layout-hint> (optional) This element specifies a layout hint for the row. It is only generated if the row has an LAYOUT element.

Currently the following buttons can be generated:

id=	Action	Description
ok	ok	Submit form and continue
cancel	cancel	Cancels the model. This button is only available on key selection screens or if the FORM has an ON EXIT statement.
back	back1	Go back one form. This button is not available on the first form of a model
next	next	Requests the next screen with keys in a key selection form.

This list can be expanded in future versions of ITP. If an application requires to show only a (possible) subset of the available buttons it should select such buttons based on the id= attribute.

Example

<itp:button id="ok">

<xforms:submit submission="ok">

<xforms:label>Ok</xforms:label> 

</xforms:submit>

</itp:button>