up Inquisit Language Reference

openended element

The openended element is a specialized trial element for gathering free recall, openended responses.

Syntax

<openended openendedname>
/ beginresponseframe = integer expression
/ beginresponsetime = integer expression
/ branch = [if expression then event]
/ buttonlabel = "string"
/ charlimit = integer
/ correctmessage = false or true(stimulusname, duration)
/ correctresponse = ("character", "character",...) or (scancode, scancode, ...) or (stimulusname, stimulusname, ...) or (mouseevent, mouseevent, ...) or (joystickevent, joystickevent, ...) or ("word", "word", ...) or (keyword) or (property, property, ...)
/ datastreams = (eyetracker) or eyetracker or false
/ defaultresponse = "text" or property or expression
/ errormessage = false or true(stimulusname, duration)
/ fontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ iscorrectresponse = [expression; expression; expression; ...]
/ isvalidresponse = [expression; expression; expression; ...]
/ linelength = integer
/ mask = constraint or regular expression
/ mouse = boolean
/ multiline = boolean
/ numframes = integer
/ numlines = integer
/ ontrialbegin = [expression; expression; expression; ...]
/ ontrialend = [expression; expression; expression; ...]
/ position = (x value, y value)
/ posttrialpause = integer expression
/ posttrialsignal = (modality, signal)
/ pretrialpause = integer expression
/ pretrialsignal = (modality, signal)
/ range = (minimum, maximum)
/ required = boolean
/ response = responsename or timeout(milliseconds) or window(center, width, stimulusname) or responsemode
/ responsefontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ responseinterrupt = mode
/ responsemessage = (responsevalue, stimulusname, duration)
/ responsetrial = (response, trialname)
/ size = (width variable, height variable)
/ stimulusframes = [framenumber = stimulusname, stimulusname, ...; framenumber = stimulusname, ...] or [framenumber = list.name] or [framenumber = selectionmode(stimulusname, stimulusname, stimulusname, ...)]
/ stimulustimes = [time = stimulusname, stimulusname, ...; time = stimulusname, ...] or [time = list.name] or [time = selectionmode(stimulusname, stimulusname, stimulusname, ...)]
/ timeout = integer expression
/ trialcode = "string"
/ trialduration = integer expression
/ validresponse = ("character", "character",...) or (scancode, scancode, ...) or (stimulusname, stimulusname, ...) or (mouseevent, mouseevent, ...) or (joystickevent, joystickevent, ...) or ("word", "word", ...) or (keyword) or (property, property, ...)
</openended>

Properties

openended.openendedname.beginresponseframe
openended.openendedname.beginresponsetime
openended.openendedname.buttonlabel
openended.openendedname.charlimit
openended.openendedname.correct
openended.openendedname.correctcount
openended.openendedname.correctstreak
openended.openendedname.count
openended.openendedname.defaultresponse
openended.openendedname.error
openended.openendedname.errorcount
openended.openendedname.errorstreak
openended.openendedname.fontheight
openended.openendedname.height
openended.openendedname.hposition
openended.openendedname.inputmask
openended.openendedname.inwindow
openended.openendedname.latency
openended.openendedname.maxlatency
openended.openendedname.maxvalue
openended.openendedname.meanlatency
openended.openendedname.medianlatency
openended.openendedname.minlatency
openended.openendedname.minvalue
openended.openendedname.multiline
openended.openendedname.name
openended.openendedname.numinwindow
openended.openendedname.percentcorrect
openended.openendedname.percentinwindow
openended.openendedname.posttrialpause
openended.openendedname.pretrialpause
openended.openendedname.required
openended.openendedname.response
openended.openendedname.responsex
openended.openendedname.responsey
openended.openendedname.sdlatency
openended.openendedname.sumlatency
openended.openendedname.timestamp
openended.openendedname.totalcorrectcount
openended.openendedname.totalcount
openended.openendedname.totalerrorcount
openended.openendedname.totalmaxlatency
openended.openendedname.totalmeanlatency
openended.openendedname.totalmedianlatency
openended.openendedname.totalminlatency
openended.openendedname.totalnuminwindow
openended.openendedname.totalpercentcorrect
openended.openendedname.totalpercentinwindow
openended.openendedname.totalsdlatency
openended.openendedname.totalsumlatency
openended.openendedname.totaltrialcount
openended.openendedname.totalvarlatency
openended.openendedname.trialcode
openended.openendedname.trialcount
openended.openendedname.trialduration
openended.openendedname.typename
openended.openendedname.varlatency
openended.openendedname.vposition
openended.openendedname.width

Functions

openended.openendedname.clearstimulusframes
openended.openendedname.insertstimulusframe
openended.openendedname.insertstimulustime
openended.openendedname.removestimulusframe
openended.openendedname.removestimulustime
openended.openendedname.resetstimulusframes
openended.openendedname.setstimulusframe
openended.openendedname.setstimulustime
openended.openendedname.stimulusframe
openended.openendedname.stimulustime

Remarks

The openended element controls the timing and the content of stimulus presentation as well as how open-ended responses are obtained. Every time a openended element is executed, a line of data is written to the data file.

The respondent can advance past this trial by hitting ENTER if openended is single line expecting keyboard input, and Ctrl+ENTER if it's multiline or set to mouse input. The default input for openended is mouse input, which enables the respondent to advance by clicking the openended element's button.

Examples

The following displays a text entry box at the bottom of the screen, sets the line length to 40 characters, and the total number of lines in the box to 3:

<openended question>
/ stimulusframes=[1=sometext]
/ position = (50, 90)
/ linelength = 40
/ numlines = 3
</openended>

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