Attributes

The ACTION_CONTROL element has the following attributes. The LABEL attribute must be present.

Table 1. Attributes of the ACTION_CONTROL Element

Attribute Name

Required

Default

Description

LABEL

See above.

 

A reference to an externalized string containing the label text for this action control. If the TYPE is ACTION, this will be the text of the hyperlink. If the TYPE is SUBMIT, this will be caption of the submit button.

LABEL_ABBREVIATION

No

 

A reference to an externalized string containing the label abbreviation text for this action control. This label abbreviation is placed only on table headers in a LIST.

TYPE

No

ACTION

The type of action control to create. There are six types: ACTION (the default) defines a link to another page, SUBMIT forwards the page's form data to the action phase for processing, DISMISS closes a pop-up page, SUBMIT_AND_DISMISS combines a submit with closing a pop-up page (see Pop-up Pages for details on working with pop-up pages), FILE_DOWNLOAD defines a link that triggers the download of a file from the server, and CLIPBOARD places a predefined value to the system clipboard. Please note, the CLIPBOARD type control is only functional in Internet Explorer as it relies on the JavaScript specific to that browser.

STYLE

No

 

The class name of the CSS style to use when formatting the action control. Supported by action controls in action sets only.

CONFIRM

No

 

Use the CONFIRM attribute of ACTION_CONTROL to force a confirmation dialog when the action control is activated.

The value of the CONFIRM attribute is a reference to the confirmation message in the page properties file.

DEFAULT

No

false

If there is more than one submit action on a page, it is useful to specify which one is executed when the user hits the Enter key. This is especially recommended when the submitting action controls are contained within the different action sets as in this case the default action could be different than the first submit action declared on the page. The default action can be specified by setting this attribute to true. Note that only one submit action on a page can have a DEFAULT value of true.

ACTION_ID

No

 

A custom identifier for action controls of TYPE = SUBMIT. It is used in conjunction with ACTION_ID_PROPERTY attribute of SERVER_INTERFACE element to inform the server side code which action control was used to make the server call.

This attribute is only valid on action controls of TYPE = SUBMIT.

The value of this attribute among the action controls within the page must be unique.

The value of this attribute must be in the format suitable for the domain associated with the property specified in the ACTION_ID_PROPERTY attribute of SERVER_INTERFACE.

This attribute must be either specified on all action controls within the page or not specified on any of them.

If this attribute is specified then the ACTION_ID_PROPERTY attribute of SERVER_INTERFACE must also be specified.

IMAGE

No

 

The value of this attribute refers to an externalized string which maps to a specific icon or graphic in the application. An action control with this attribute can only be used within a CONTAINER element.

ALIGNMENT

No

RIGHT

When contained in a page level ACTION_SET of a Modal Dialog, the ALIGNMENT attribute is supported. This will define the individual horizontal alignment of the action control. It can be set to LEFT or RIGHT. The default is to right aligned.