EntryField control

The EntryField control is used for creating single-line text input fields where users can enter text. You can define the position, size, and appearance of the entry field, as well as set various input restrictions.

Available tags

In addition to the default control tags, the EntryField control has the following unique tag:

Tag	Description
`TEXTENTRYDATA`	Defines specific properties of the entry field, such as input limits and allowed input types.

Default values and usage

The following section lists the default values and available textures for each tag:

Click to expand

TEXTENTRYDATA

MAXLEN: An integer that defines the maximum length of the input text (e.g., 64).
SECRETTEXT: A Boolean value that defines whether input text should be hidden (0 = normal, 1 = hidden, displayed as asterisks).
NUMERICALONLY: A Boolean value that defines whether the entry field allows only numbers (0 = allows all characters, 1 = only numbers).
ALPHANUMERICALONLY: A Boolean value that defines whether the entry field allows only letters and numbers (0 = allows all characters, 1 = only letters and numbers).
ASCIIONLY: A Boolean value that defines whether the entry field allows only ASCII characters (0 = allows non-ASCII, 1 = only ASCII).

ENABLEDDRAWDATA

TextEntryEnabledLeftEnd
TextEntryEnabledRightEnd
TextEntryEnabledRepeatingCenter
TextEntryEnabledSmallRepeatingCenter

DISABLEDDRAWDATA

TextEntryDisabledLeftEnd
TextEntryDisabledRightEnd
TextEntryDisabledRepeatingCenter
TextEntryDisabledSmallRepeatingCenter

HILITEDRAWDATA

TextEntryHiliteLeftEnd
TextEntryHiliteRightEnd
TextEntryHiliteRepeatingCenter
TextEntryHiliteSmallRepeatingCenter

Example

Here’s an example from the OptionsMenu.wnd file:

Click to expand

WINDOW
  WINDOWTYPE = ENTRYFIELD;
  SCREENRECT = UPPERLEFT: 520 372,
               BOTTOMRIGHT: 640 397,
               CREATIONRESOLUTION: 800 600;
  NAME = "OptionsMenu.wnd:TextEntryHTTPProxy";
  STATUS = ENABLED+IMAGE;
  STYLE = ENTRYFIELD+MOUSETRACK;
  SYSTEMCALLBACK = "[None]";
  INPUTCALLBACK = "[None]";
  TOOLTIPCALLBACK = "[None]";
  DRAWCALLBACK = "[None]";
  FONT = NAME: "Arial", SIZE: 10, BOLD: 0;
  HEADERTEMPLATE = "TextEntry";
  TOOLTIPTEXT = "TOOLTIP:HTTPProxy";
  TOOLTIPDELAY = -1;
  TEXT = "Entry";
  TEXTCOLOR = ENABLED:  254 254 254 255, ENABLEDBORDER:  0 0 0 255,
              DISABLED: 192 192 192 255, DISABLEDBORDER: 64 64 64 255,
              HILITE:   168 255 12 255, HILITEBORDER:   0 0 128 255;
  ENABLEDDRAWDATA = IMAGE: TextEntryEnabledLeftEnd, COLOR: 0 0 0 255, BORDERCOLOR: 0 0 0 255,
                    IMAGE: TextEntryEnabledRightEnd, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                    IMAGE: TextEntryEnabledRepeatingCenter, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                    IMAGE: TextEntryEnabledSmallRepeatingCenter, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                    IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                    IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                    IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                    IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                    IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0;
  DISABLEDDRAWDATA = IMAGE: TextEntryDisabledLeftEnd, COLOR: 0 0 128 255, BORDERCOLOR: 0 0 0 255,
                     IMAGE: TextEntryDisabledRightEnd, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                     IMAGE: TextEntryDisabledRepeatingCenter, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                     IMAGE: TextEntryDisabledSmallRepeatingCenter, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                     IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                     IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                     IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                     IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                     IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0;
  HILITEDRAWDATA = IMAGE: TextEntryHiliteLeftEnd, COLOR: 0 0 0 255, BORDERCOLOR: 0 0 0 255,
                   IMAGE: TextEntryHiliteRightEnd, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                   IMAGE: TextEntryHiliteRepeatingCenter, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                   IMAGE: TextEntryHiliteSmallRepeatingCenter, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                   IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                   IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                   IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                   IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0,
                   IMAGE: NoImage, COLOR: 255 255 255 0, BORDERCOLOR: 255 255 255 0;
  TEXTENTRYDATA = MAXLEN: 64,
                  SECRETTEXT: 0,
                  NUMERICALONLY: 0,
                  ALPHANUMERICALONLY: 0,
                  ASCIIONLY: 1;
END

See also