up Inquisit Language Reference

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

textbox.textboxname.caption
textbox.textboxname.defaultresponse
textbox.textboxname.fontheight
textbox.textboxname.height
textbox.textboxname.hposition
textbox.textboxname.maxchars
textbox.textboxname.maxvalue
textbox.textboxname.minchars
textbox.textboxname.minvalue
textbox.textboxname.name
textbox.textboxname.required
textbox.textboxname.response
textbox.textboxname.responsefontheight
textbox.textboxname.subcaption
textbox.textboxname.subcaptionfontheight
textbox.textboxname.textboxheight
textbox.textboxname.textboxwidth
textbox.textboxname.typename
textbox.textboxname.vposition
textbox.textboxname.width

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>

Send comments on this topic:
Copyright Millisecond Software, LLC. All rights reserved.