Using Zen Components - InterSystems Documentation

Zen ControlsAttributeoriginalValuereadOnlyrequiredrequiredMessageDescriptionOriginal value for this control before any user modification. It is used to detect whichcontrols have been modified. This is a special value in that it is automatically initializedwhen a form is displayed.On the client side, do not access this property directly; instead use the getProperty andsetProperty client-side methods. Note that setting the originalValue property on theclient (via setProperty) will reset it to the current value of this control.If true, this control is read-only. The user cannot change the value of this control, but thecontrol still appears on the form and still submits its value when the form that contains itis submitted. Setting readOnly to true effectively disables the component; this is thestandard HTML behavior for select controls. The default readOnly value is false.This attribute has the underlying data type %ZEN.Datatype.boolean. It has the value "true"or "false" in XData Contents, 1 or 0 in server-side code, true or false in client-side code.If true, this control is required. That is, a user must supply a value for this control or thedefault form validation logic will fail.This attribute has the underlying data type %ZEN.Datatype.boolean. It has the value "true"or "false" in XData Contents, 1 or 0 in server-side code, true or false in client-side code.Message text that the form validate method displays in an alert box when this control isrequired and does not have a value. The default requiredMessage text is:required.Although you can enter ordinary text for this attribute, it has the underlying data type%ZEN.Datatype.caption.This makes it easy to localize its text into other languages, as longas a language DOMAIN parameter is defined in the Zen page class. The%ZEN.Datatype.caption data type also enables you to use $$$Text macros when you assignvalues to the requiredMessage property from client-side or server-side code.tabIndexvalueInteger used to provide a value for the HTML tabIndex attribute. The browser uses thisattribute to control the tab order of controls within a form.Default value displayed within this control.This is a special value in that it is automaticallyinitialized when a form is displayed. The value can be a literal string, or it can contain aZen #()# runtime expression.On the client side, do not access this property directly; instead use the getValue andsetValue client-side methods.5.2 Data Drag and DropAll Zen controls support data drag and drop functionality as follows:• Data drag and drop features work only if the containing has its dragAndDrop attribute set to true.• A data drag from a control occurs when the user clicks the mouse button down while the cursor is positioned on thecontrol, then moves the mouse away from the control while still holding down the button. Data drag captures the currentvalue of the control where the drag operation began. If the logical value and displayed value are different, this difference104 Using Zen Components