Access
To insert an Entry field object, you must either:
Choose the Adelia Web Studio Objects/Entry field 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 Entry field object.
General
Data entry
Name
Adelia guide word of the field.
Type
Field's Adelia type.
Possible values:
Alphanumerical,
Short binary,
Long binary,
Packed,
Date,
Extended,
Time,
Timestamp.
Length
Field's Adelia length.
This field is only visible if the type indicated in the Type field is Alphanumerical, Packed or Extended.
Decimals
Number of decimal places in the field.
This field is only visible if the type indicated in the Type field is Packed or Extended.
Edit word
Edit word defining a layout for a numerical field if the list of edit codes is insufficient.
This field is protected if it comes from the data type or original conceptual property.
This field cannot be filled in if an edit code has been chosen.
If an edit word is entered, it is subject to the following constraints:
- the length of the edit word must be equal to that of the type;
- this length is calculated by counting only the spaces.
Optional field.
This field is only visible if the type indicated in the Type field is Packed or Extended and if no edit code has been selected.
Edit code
Lets you indicate a code corresponding to a display format for the variable. These codes are available in the combo box.
An edit code cannot be chosen if an edit word has been entered.
This field is only visible if the type indicated in the Type field is Condensed or Extended.
Input control
List of input controls supported by the object.
The selected control defines the keyboard input control.
When the program is run, the input control makes it possible to select a set of characters that are valid for the content of the input field during input by the user.
This field is only visible if the type indicated in the Type field is Alphanumerical, Date, Packed or Extended.
Styles
Check boxes
Active
Checked |
Activation of entry field. |
Not checked |
Deactivation of entry field. It is grayed out and inaccessible. |
Read only
Checked |
The entry field is in "read only" mode and the user cannot enter any values. |
Show input
Checked |
The data entered by the user is visible (password input). |
Not checked |
The data entered by the user is not visible (password input). |
Multiline
Checked |
Enables an entry field to be presented on several lines. The Li. / Co. fields let you specify the number of rows/columns in a multiple-line type entry field. |
Mandatory
Checked |
Lets you define a required field. If the form is submitted and no value has been entered, an error is detected. |
Hidden
Checked |
The entry field is hidden. This field corresponds to a "hidden" HTML input tag. |
Event
Check boxes
onChange
Checked
|
An Adelia event processing block is assigned, in response to a change to the value. |
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 onChange event processing block to the entry field object.
This processing block is run in response to a click on the entry field.
Note: Adding an onChange event processing block to an entry field object called OBJ_1 will create an event block, OBJ_1:ONCHANGE, in the 4GL source when the HTML page is saved. OBJ_1:ONCHANGE 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 onChange event processing block in the entry field 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 OnChange event processing block to the Entry Field object. This event requires validation; in addition it triggers the uploading of the files selected by an Upload object.
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).