To insert a Button object, you must either:

  • Choose the Adelia Web Studio Objects/Button option from the Insert menu in the Macromedia Dreamweaver window.

  • Click on the corresponding button in the Adelia object insertion bar in Dreamweaver.

 

This dialog box lets you define the different attributes of the Button object.

 

General

Data entry

Name

Button name identifier.

 

Text

Button description.

The description cannot be completed if an image source has been entered.

 

Image

Source of the image associated with the button.

The relevant button opens a dialog box that lets you select an image.

The image source cannot be completed if a description has been entered.

 

Styles
Active

Checked

Button enabled.

Not checked

Button disabled.

It is grayed out and inaccessible.

 

Width

Lets you define the image width, on condition that the Image radio button is selected.

 

Height

Lets you define the image height, on condition that the Image radio button is selected.

 

Default

Checked

The HTML page's default button is used.

 

Note: The HTML page's default button is shown surrounded with a thin black outline.

If one or more buttons with images are placed on the page, the default button's outline is not drawn. The same applies if the user has assigned a prompt to a field, because the prompt places a button with an image on the page.

 

Event
onClick

Checked

 

An Adelia event processing block is assigned, in response to a mouseclick on the button. This event is either an OnClick event on the button, or a rollup event (OnRollup) or rolldown event (OnRolldown) on the ListName list declared via the ::ADELIA_ROLLUP(ListName) directive or the ::ADELIA_ROLLDOWN(ListName) directive.

 

Reversible (drop-down menu)

Defines whether the OnClick event can be canceled by clicking on the browser's Previous button.

Possible values:

Reversible

The event can be cancelled.

Irreversible

The event cannot be cancelled.

Dummy

The event does not enable the browser's Previous button. If this button was already enabled before executing a dummy event, clicking on it cancels the last event triggered before the dummy event. A dummy event must be an Ajax event.

 

Note: This option is only available if the WADELIA program was created with browser Previous / Next button support enabled.

 

AJAX

Checked

Defines an AJAX event.

 

Event (combo menu)

Lets you add an OnClick event processing block to the button object.

This processing block is run in response to a click on the button.

 

Note: Adding an ONCLICK event processing block to a button object called OBJ_1 will create an event block, OBJ_1:ONCLICK, in the 4GL source when the HTML page is saved. OBJ_1:ONCLICK is nested in the OBJ_1 object block, which is in turn nested in the WORK WITH EVENTS block.

 

 

Event w/o validation

Lets you add and run an ONCLICK event processing block in the button object, without checking the validity of the fields in the HTML page in any way.

Note: The Adelia variables linked to the graphical objects in the page are not updated.

 

Upload event

Lets you add an OnClick event processing block to the Button object. This event requires validation; in addition it triggers the uploading of the files selected by an Upload object.

 

Note: If there is an Upload object in the form that contains the button, the Rollup and Rolldown events trigger the uploading of the file selected by this object.

 

Rollup

Lets you add an OnRollUp event processing block to the associated list object. (The object is selected in the lower list in the window).

The event processing block is run in response to a click on the button.

Rollup is only available if there are one or more list objects (i.e. if the window's lower list is not empty).

Note: Adding an OnRollUp event processing block to a list object called TBL_1 will create an event block, TBL_1:ONROLLUP, in the 4GL source when the HTML page is saved. TBL_1:ONROLLUP is nested in the TBL_1 object block, which is in turn nested in the WORK WITH EVENTS block.

 

 

Rolldown

Lets you add an OnRollDown event processing block to the associated list object. (The object is selected in the lower list in the window).

The event processing block is run in response to a click on the button.

Rolldown is only available if there are one or more list objects (i.e. if the window's lower list is not empty).

Note: Adding an OnRollDown event processing block to a list object called TBL_1 will create an event block, TBL_1:ONROLLDOWN, in the 4GL source when the HTML page is saved. TBL_1:ONROLLDOWN is nested in the TBL_1 object block, which is in turn nested in the WORK WITH EVENTS block.

 

 

Click here for more information about the Adelia event processing blocks.

 

AJAX parameters
Asynchronous

Checked

Defines an asynchronous AJAX event. An asynchronous event does not block the user interface. The interface continues to respond while the event is processed on the Web application server.

 

Behavior

Defines the strategy followed in the event of simultaneous execution requests for the event.

Possible values:

Different event

Proceeds as for two different events and follows the rule defined for different queries (cf. SIMULTANEOUS_DIFFERENT_REQUESTS_RULE in Parameters of the AWSAjax.properties file).

Previous event canceled

Cancels the previous event (physically breaking the HTTP connection if the previous event is running, or removing it from the queue if it is pending execution).

Event canceled

Ignores the second event, regardless of the state of the first event (i.e. running or pending).

 

Timer

Defines the wait time between successive executions of the same event. The presence of a value in this field indicates that the event is cyclical: once executed, it is automatically repeated indefinitely.

The possible unit values are:

- Millisec. for milli-seconds,

- Second,

- Minute,

- Hour.

This value must not exceed the life of an HTTP session (as specified in the file web.xml).

 

Priority

Sets an event's priority when it is placed in the queue. This priority defines the order of execution of the events in the queue.

This value must be between REQUEST_MIN_PRIORITY and REQUEST_MAX_PRIORITY.

If this field is left blank, the priority is set to REQUEST_DEFAULT_PRIORITY (refer to these values in Parameters of the AWSAjax.properties file).

 

Invisible

Hides the progress bar when this event is triggered.

This parameter is only processed if PROGRESS_INDICATOR_SHOW_ALL_STARTED_REQUEST is set to "N" (see Parameters of the AWSAjax.properties file).

 

Context-sensitive menu
Menu name

Associates a context-sensitive menu with the object. It is possible to associate multiple Adelia objects with the same Menu object (the Menu object's SOURCE_OBJ property, when used in the event processing block of a menu or menu, identifies the Adelia object for which the user has opened the menu).

 

Event

Specifies the Javascript event that will cause the associated context-sensitive menu to open.

Possible values:

onclick

Causes the menu to open when the user clicks the control.

oncontextmenu

Causes the menu to open when the user right-clicks the control. By default, the browser opens a system menu when this event is triggered. To display the system menu instead of the Adelia menu, press the Ctrl key while right-clicking.

onmousedown

Causes the menu to open when the user presses down the left mouse button over the control.

onmouseover

Causes the menu to open when the user moves the mouse pointer over the control.

onmouseup

Causes the menu to open when the user releases the left mouse button over the control.

 

Note: For the sake of ergonomics, when the Javascript event that opens a menu is based on a mouse click (oncontextmenu, onclick, onmousedown or onmouseup), the "Close by clicking on page background" property defined during the layout design of the Menu object should be enabled.

This property should be disabled when the Javascript event is based on a mouse movement (onmouseover).

 

Buttons

This button opens a dialog box that lets you assign resources to a program.

 

 

↑ Top of page