DdsCharFieldTagHelper class | QSYS API Reference Guide

Estimated reading time: 2 minutes

Defines an input element where characters can be typed using a keyboard. The captured value will be posted as the value entered into a field.

Namespace: ASNA.QSys.Expo.Tags Assembly: ASNA.QSys.Expo.Tags.dll

Inheritance: Object –> TagHelper –> FieldBase –> DdsFieldBase

Remarks

To define an input-capable Fixed String, use the DdsCharField Tag Helper.

For example, the following markup defines an input text element for the field SFNAME in the CUSTREC record (defined in the Model).

<div Row="4">
    .
    .
    .
    <DdsCharField Col="27" For="CUSTREC.SFNAME" PositionCursor="67"/>
</div>

The field SFNAME is defined in the Model file, like so:

public class CUSTREC_Model : RecordModel
{
    .
    .
    .
    [Char(40)]
    public string SFNAME { get; set; }

Note how the Char attribute defines the fixed length of 40 characters. The property accessors define the field Usage. In this example, the field is public get and public set, defining it as BOTH readable as well as writable.

Properties

Type Name Description
Boolean LimitMaxLength Gets or sets a value that indicates whether to set a limit on the maximum characters allowed to be typed on the field. Defaults to true. When true, the maximum allowed characters will be set to the Length of the field.
String MessageIdExpression Gets or sets a conditionalal property string that indicates which message of a message file will be used to extract the text associated with the message. Format is comma-separated list of ‘MessageID MessageFileName[:optional indicator expression]’.
Int32 MultilineColWidth Gets or sets a value that indicates the width of the multi-line text area expressed in legacy character count. When used in a Browser, more characters may be entered per line, but the box will have the legacy pixel width.
Boolean SpellCheck Gets or sets a value that indicates the HTML spellcheck attribute used during rendering.
String ValuesText Gets or sets a value that describes valid display values. Each text description is single-quoted. List is comma separated. ValuesText can be used to display the field as a dropdown box.
String ValuesTextOptionSeparator Gets or sets the string that will be used to separate Value and Text for ValuesText. Defaults to not prepend values to ValuesText.

Methods

Signature Description
getFieldValue() Gets the value of the field from the Model.

string getFieldValue()

Gets the value of the field from the Model.

string getFieldValue()