Products Downloads


French version


 

Authorizes execution of 4GL code placed in the ONSUGGEST event processing block. If the value is set to *TRUE, then the Autosuggest object is in automatic results list processing mode: the 4GL code placed in the ONSUGGEST block is not run.

Adelia type

BOOL.

Accessibility

Read / Write.

Conditions for use

None.

Default value

*TRUE.

 

 

Defines the size of the Autosuggest object cache (in number of results list elements). If the size is 0, then cache management is disabled.

Adelia type

NUM_BIN_4.

Accessibility

Read / Write.

Conditions for use

If the value is 0, then the cache is disabled. The Autosuggest object cache has a defined life span. When recreated (upon page load via a non-Ajax event, or when the object is hidden then shown in consecutive Ajax event processing blocks), the cache is emptied.

Default value

100.

 

 

Assigns the object a class containing various presentation characteristics.

Adelia type

ALPHA(256).

Accessibility

Read / Write.

Conditions for use

none.

Default value

*BLANK.

 

 

Defines a selection criterion to apply when calculating the results list.

The choice of criterion influences cache management performance: this latter is less efficient with the "ends with" criterion as it is impossible to drill down the search based on characters entered (e.g.: "a", then "ab").

If the user wishes to define his/her own selection criterion, he/she simply configures the object in manual results list calculation mode (set the AUTOMATIC_MODE property to *FALSE) and implement his/her own search algorithm.

Adelia type

NUM_BIN_2.

Accessibility

Read / Write.
Associated constants  

_AWSASG_STARTS_WITH

"starts with" criterion,

_AWSASG_CONTAINS

"contains" criterion,

_AWSASG_ENDS_WITH

"ends with" criterion,

Conditions for use

If the cache is enabled, then assigning a value to this property results in cache deletion.

Default value

_AWSASG_STARTS_WITH.

 

 

Allows to assign a specific value-related text to an element in the list.

Adelia type

Defined during layout design.

Accessibility

Read / Write.

Conditions for use

The Autosuggest object must be in Combo mode and must support a value-related text.

Default value

Default value matching the Adelia type.

 

 

Allows to manage the list (add, modify an element, browse the list, etc.).

Adelia type

Defined when designing layout.

Accessibility

Read / Write.

Conditions for use

The Autosuggest object must be in combo mode.

Default value

Default value matching the Adelia type.

 

 

Allows to define whether the Autosuggest object is enabled.

Adelia type

BOOL.

Accessibility

Read / Write.

Conditions for use

none.

Default value

*TRUE.

 

 

Defines a results list footer value-related text. This footer can either be a text, or an HTML fragment. It is displayed at the bottom of the results list.

Adelia type

ALPHA(256).

Accessibility

Read / Write.

Conditions for use

This property is only supported if the Autosuggest object is in combo mode.

Default value

*BLANK.

 

 

Defines a results list header value-related text. This header can either be a text, or an HTML fragment. It is displayed above the first item in the results list.

Adelia type

ALPHA(256).

Accessibility

Read / Write.

Conditions for use

This property is only supported if the Autosuggest object is in combo mode.

Default value

*BLANK.

 

 

Defines the CSS class used to distinguish the selected element in the results list.

Adelia type

ALPHA(256).

Accessibility

Read / Write.

Conditions for use

none.

Default value

AWSAutosuggestHighlight.

 

 

Defines the CSS style class used to display each element in the results list. It is used only for an object in Combo mode.

Adelia type

ALPHA(256).

Accessibility

Read / Write.

Conditions for use

This property is only supported if the Autosuggest object is in combo mode.

Default value

*BLANK.

 

 

Value present in the entry field.

Adelia type

Defined when designing layout.

Accessibility

Read / Write.

Conditions for use

The Autosuggest object must support a value-related text. When assigning a value to this property, if this value is part of the associated list and is unique, then the VALUE property is updated with the corresponding value; else the property is updated with the specified extreme case value.

Default value

Default value matching the Adelia type.

 

 

When processing the ONSUGGEST event, if the MORE_ELEMENTS property has been set to *TRUE, then this property must possess a value identifying the last element added to the results list (e.g.: this element's rank in the associated list, its value, its value-related text, or any other value used to identify this element).

 

If the ONSUGGEST event is triggered by a click on the text, indicating that other values exist (see the MAXIMUM_RESULT property), then the value of the property is that assigned when processing the ONSUGGEST event that generated the results list.

Adelia type

ALPHA(256).

Accessibility

Read / Write.

Conditions for use

This property is only supported in manual results list calculation mode, when the MAXIMUM_RESULT property has a positive value. It must be used in conjunction with the MORE_ELEMENTS property.

Default value

*BLANK.

 

 

List of elements.

Adelia type

LIST.

Accessibility

Read / Write.

Conditions for use

This property is only supported if the Autosuggest object is in combo mode.

Default value

None.

 

 

Defines the CSS style class applied to the results list container (DIV tag).

Adelia type

ALPHA(256).

Accessibility

Read / Write.

Conditions for use

none.

Default value

AWSAutosuggestHighlight.

 

 

Defines a maximum height for displaying the results list. This height is defined by a value followed by a unit (e.g.: "120px", "200em"). When the actual list height is greater than its maximum height, then a vertical scrollbar is displayed to the right of the list elements.

Adelia type

ALPHA(10).

Accessibility

Read / Write.

Conditions for use

none.

Default value

*BLANK.

 

 

Defines a width for displaying the results list. This width is defined by a value followed by a unit (e.g.: "120px", "200em").

Adelia type

ALPHA(10).

Accessibility

Read / Write.

Conditions for use

none.

Default value

*BLANK.

 

 

Defines the maximum number of result values returned. This property prevents excessive numbers of results. If this number is set to -1, all possible values are returned. If this number is possible, then a text indicating that there are other values is shown at the bottom of the results list. Clicking this text displays the other results by triggering an ONSUGGEST event. This text can be internationalized.

Adelia type

NUM_BIN_2.

Accessibility

Read / Write.

Conditions for use

This property is only supported in automatic results list calculation mode. In manual mode, the user is responsible for limiting the number of items present in the results list according to this value. Moreover, he/she must manage the text click, indicating that there are other values via the MORE_ELEMENTS and KEY_LAST_ELEMENT properties.

If the cache is enabled, then assigning a value to this property results in cache deletion.

Default value

-1.

 

 

Defines the minimum number of characters entered by the user beyond which the Autosuggest object triggers a request for result values.

Adelia type

NUM_BIN_2.

Accessibility

Read / Write.

Conditions for use

The value must be greater than or equal to 1.

Default value

1.

 

 

When processing the ONSUGGEST event, this property must possess the value *TRUE if there is at least one other element meeting the selection criterion but that is not part of the results list, when the maximum number of elements in this list has been reached (see the MAXIMUM_RESULT property).

Adelia type

BOOL.

Accessibility

Read / Write.

Conditions for use

This property is only supported in manual results list calculation mode, when the MAXIMUM_RESULT property has a positive value.

Default value

*FALSE.

 

 

Prevents the keyboard being used to enter text in the Autosuggest object.

Adelia type

BOOL.

Accessibility

Read / Write.

Conditions for use

none.

Default value

*FALSE.

 

 

Value of the Autosuggest object.

Adelia type

Defined when designing layout.

Accessibility

Read / Write.

Conditions for use

None.

Default value

Default value matching the Adelia type.

 

 

Visibility of the Autosuggest object.

Adelia type

BOOL.

Accessibility

Read / Write.

Conditions for use

None.

Default value

*TRUE.

 

 

 

 

 

 

↑ Top of page