textbox element

The textbox element defines a survey item in which respondents enter free text.

Syntax

<textbox textboxname>
/ caption = "text"
/ correctresponse = ("character", "character",...) or (scancode, scancode, ...) or (stimulusname, stimulusname, ...) or (mouseevent, mouseevent, ...) or (joystickevent, joystickevent, ...) or ("word", "word", ...) or (keyword) or (property, property, ...)
/ defaultresponse = "text" or property or expression
/ fontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ mask = constraint or regular expression
/ maxchars = integer
/ minchars = integer
/ multiline = boolean
/ orientation = layout
/ position = (x value, y value)
/ range = (minimum, maximum)
/ required = boolean
/ responsefontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ size = (width variable, height variable)
/ subcaption = "text"
/ subcaptionfontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ textboxsize = (width variable, height variable)
/ txcolor = (red value, green value, blue value) or color name or color value
/ txcolor = (red value, green value, blue value) or color name or color value
/ validresponse = ("character", "character",...) or (scancode, scancode, ...) or (stimulusname, stimulusname, ...) or (mouseevent, mouseevent, ...) or (joystickevent, joystickevent, ...) or ("word", "word", ...) or (keyword) or (property, property, ...)
</textbox>

Properties

Functions

None.

Remarks

The textbox element has a powerful set of features for validating and constraining the range of permissible input. See the mask attribute for details.

Examples

The following textbox item asks the respondent to enter their age, constraining the response to be a positive integer between 18 and 120.

<textbox q1>
/ caption="Please enter your age."
/ mask=positiveinteger
/ range = (18, 120)
</textbox>