openended element

Attributes

<openended name>
/ buttonLabel = string
/ charLimit = integer
/ charLimit = expression
/ defaultResponse = text
/ defaultResponse = integer
/ defaultResponse = expression
/ lineLength = value
/ lineLength = expression
/ mask = constraint
/ mask = regex
/ multiline = boolean
/ numLines = integer
/ numLines = expression
/ position = (x, y)
/ position = (xexpression, yexpression)
/ range = (min, max)
/ range = (minexpression, maxexpression)
/ required = boolean
/ required = expression
/ fontStyle = (name, height, bold, italic, underline, strikeout, quality, characterset)
/ mouse = boolean
/ navigationButtonFontStyle = (name, height, bold, italic, underline, strikeout, quality, characterset)
/ position = (x, y)
/ position = (xexpression, yexpression)
/ responseFontStyle = (name, height, bold, italic, underline, strikeout, quality, characterset)
/ size = (width, height)
/ size = (widthexpression, heightexpression)
/ beginResponseFrame = integer
/ beginResponseFrame = expression
/ beginResponseTime = integer
/ beginResponseTime = value
/ correctResponse = (character, character,...)
/ correctResponse = (scancode, scancode, ...)
/ correctResponse = (anyResponse, noResponse, ...)
/ correctResponse = (stimulusname, stimulusname, ...)
/ correctResponse = (mouseevent, mouseevent, ...)
/ correctResponse = (gamepadstickevent, gamepadevent, ...)
/ correctResponse = (joystickevent, joystickevent, ...)
/ correctResponse = (word, word, ...)
/ correctResponse = (response)
/ correctResponse = (expression, expression, ...)
/ draw = stimulusname
/ dropSources = (stimulus, stimulus, expression, expression, ...)
/ dropTargets = (stimulus, stimulus, expression, expression, ...)
/ inputDevice = device
/ inputMask = mask
/ isCorrectResponse = { script }
/ isValidResponse = { script }
/ monkeyResponse = (character, character,...)
/ monkeyResponse = (scancode, scancode, ...)
/ monkeyResponse = (anyResponse, noResponse, ...)
/ monkeyResponse = (stimulusname, stimulusname, ...)
/ monkeyResponse = (mouseevent, mouseevent, ...)
/ monkeyResponse = (gamepadevent, gamepadevent, ...)
/ monkeyResponse = (joystickevent, joystickevent, ...)
/ monkeyResponse = (word, word, ...)
/ monkeyResponse = (keyword)
/ monkeyResponse = (expression, expression, ...)
/ postTrialPause = integer
/ postTrialPause = expression
/ postTrialSignal = (modality, signal)
/ postTrialSignal = (mouse, stimulusname)
/ postTrialSignal = (mouse, mouseevent)
/ preTrialPause = integer
/ preTrialPause = expression
/ preTrialSignal = (modality, signal)
/ preTrialSignal = (mouse, stimulusname)
/ preTrialSignal = (mouse, mouseevent)
/ responseInterrupt = mode
/ responseMessage = bool(responsevalue, stimulusname, duration)
/ responseMessage = (responsevalue, stimulusname, duration)
/ stimulusFrames = [framenumber = stimulusname, stimulusname, ...; framenumber = stimulusname, ...]
/ stimulusFrames = [framenumber = listname]
/ stimulusFrames = [framenumber = selectMode(stimulusname, stimulusname, stimulusname, ...)]
/ stimulusTimes = [time = stimulusname, stimulusname, ...; time = stimulusname, ...]
/ stimulusTimes = [time = listname]
/ stimulusTimes = [time = selectMode(stimulusname, stimulusname, stimulusname, ...)]
/ stop = { script }
/ trialDuration = integer
/ trialDuration = expression
/ undoDraw = { script }
/ validResponse = (character, character,...)
/ validResponse = (scancode, scancode, ...)
/ validResponse = (anyResponse, noResponse, ...)
/ validResponse = (stimulusname, stimulusname, ...)
/ validResponse = (mouseevent, mouseevent, ...)
/ validResponse = (gamepadevent, gamepadevent, ...)
/ validResponse = (joystickevent, joystickevent, ...)
/ validResponse = (word, word, ...)
/ validResponse = (keyword)
/ validResponse = (expression, expression, ...)
/ branch = { script }
/ correctMessage = true(stimulusname, duration)
/ correctMessage = false
/ dataStreams = (datastream, eyetracker)
/ dataStreams = false
/ errorMessage = true(stimulusname, duration)
/ errorMessage = false
/ onTrialBegin = { script }
/ onTrialEnd = { script }
/ photoCapture = boolean
/ quit = { script }
/ recordData = option
/ response = responsename
/ response = timeout(milliseconds)
/ response = window(center, width, stimulusname)
/ response = responsemode
/ screenCapture = boolean
/ showMouseCursor = boolean
/ skip = { script }
/ soundCapture = boolean
/ stop = { script }
/ timeout = integer
/ timeout = expression
</openended>

Properties

Functions

openended.name.clearStimulusFrames
openended.name.insertStimulusFrame
openended.name.insertStimulusTime
openended.name.removeStimulusFrame
openended.name.removeStimulusTime
openended.name.resetStimulusFrames
openended.name.setStimulusFrame
openended.name.setStimulusTime
openended.name.stimulusFrame
openended.name.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>
/ stimulusTimes=[0=myText]
/ position = (50, 90)
/ lineLength = 40
/ numlines = 3
</openended>