WEBCOMPONENT item type

The WEBCOMPONENT item type defines a generic form field that can receive an external widget.

Syntax

WEBCOMPONENT item-tag = field-name [ , attribute-list ] ;
  1. item-tag is an identifier that defines the name of the item tag in the layout section.
  2. field-name identifies the name of the screen record field.
  3. attribute-list defines the aspect and behavior of the form item.

Attributes

COLOR, COLOR WHERE, COMPONENTTYPE, COMMENT, DEFAULT, FONTPITCH, HEIGHT, HIDDEN, INCLUDE, JUSTIFY, NOT NULL, NOENTRY, PROPERTIES, REQUIRED, SCROLLBARS, SIZEPOLICY, STYLE, STRETCH, TAG, TABINDEX, VALIDATE LIKE, WIDTH.

Table column only: UNSORTABLE, UNSIZABLE, UNHIDABLE, UNMOVABLE, TITLE.

Usage

The WEBCOMPONENT form item type defines a form field which can be implemented with a plug-in mechanism on the front-end side.

You must define the type of the widget with the COMPONENTTYPE attribute. This attribute is mandatory to identify the external widget that will be used for this field.

The SCROLLBARS and STRETCH attributes can be used to define the behavior of the widget regarding sizing.

The PROPERTIES attribute is typically used to define attributes that are specific to a given web component. For example, a chart component might have properties to define x-axis and y-axis labels.

The value of a WEBCOMPONENT field is usually (XML) formatted, and holds the data that will be rendered by the external widget through the JavaScriptâ„¢ shell.

WEBCOMPONENT f001 = FORMONLY.mycal,
     COMPONENTTYPE="Calendar",
     STRETCH=BOTH, STYLE="regular";