openended element

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

Syntax

<openended openendedname>
/ 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)
/ errormessage = false or true(stimulusname, duration)
/ fontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ linelength = integer
/ mouse = boolean
/ multiline = boolean
/ numframes = integer
/ ontrialbegin = [expression; expression; expression; ...]
/ ontrialend = [expression; expression; expression; ...]
/ position = (x expression, y expression)
/ posttrialpause = integer expression
/ posttrialsignal = (modality, signal)
/ pretrialpause = integer expression
/ pretrialsignal = (modality, signal)
/ response = responsename or timeout(milliseconds) or window(center, width, stimulusname) or responsemode
/ responseframe = integer
/ responseinterrupt = mode
/ responsemessage = (responsevalue, stimulusname, duration)
/ responsetime = integer
/ responsetrial = (response, trialname)
/ size = (width expression, height expression)
/ stimulusframes = [framenumber = stimulusname, stimulusname, ...; framenumber = stimulusname, ...] or [framenumber = selectionmode(stimulusname, stimulusname, stimulusname, ...)]
/ stimulustimes = [time = stimulusname, stimulusname, ...; time = stimulusname, ...] or [time = selectionmode(stimulusname, stimulusname, stimulusname, ...)]
/ timeout = integer expression
/ trialcode = "string"
/ trialdata = [stimulusname, stimulusname, stimulusname, "string" "string", "string"]
/ trialduration = integer expression
/ validresponse = ("character", "character",...) or (scancode, scancode, ...) or (stimulusname, stimulusname, ...) or (mouseevent, mouseevent, ...) or (joystickevent, joystickevent, ...) or ("word, word, ...") or (keyword)
</openended>

Properties

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.

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>