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)
/ iscorrectresponse = [expression; expression; expression; ...]
/ isvalidresponse = [expression; expression; expression; ...]
/ linelength = integer
/ mask = constraint or regular expression
/ monkeyresponse = ("string", "string",...) or (scancode, scancode, ...) or (property, property, ...) or [expression; expression; expression;...]
/ mouse = boolean
/ multiline = boolean
/ navigationbuttonfontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ numframes = integer
/ numlines = integer
/ ontrialbegin = [expression; expression; expression; ...]
/ ontrialend = [expression; expression; expression; ...]
/ position = (x value, y value)
/ posttrialpause = integer expression
/ posttrialsignal = (modality, signal) or (mouse, stimulusname) or (mouse, mouseevent)
/ pretrialpause = integer expression
/ pretrialsignal = (modality, signal) or (mouse, stimulusname) or (mouse, mouseevent)
/ quit = [expression; expression; expression; ...]
/ range = (minimum, maximum)
/ recorddata = boolean
/ 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)
/ screencapture = boolean
/ showmousecursor = boolean
/ size = (width variable, height variable)
/ skip = [expression; expression; expression; ...]
/ 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, ...)]
/ stop = [expression; expression; expression; ...]
/ timeout = integer expression
/ 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

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>