surveypage element

Attributes

<surveyPage name>
/ backButtonPosition = (x, y)
/ backLabel = label
/ caption = text
/ finishLabel = label
/ fontStyle = (name, height, bold, italic, underline, strikeout, quality, characterset)
/ itemFontStyle = (name, height, bold, italic, underline, strikeout, quality, characterset)
/ itemSpacing = height
/ itemSpacing = expression
/ navigationButtonFontStyle = (name, height, bold, italic, underline, strikeout, quality, characterset)
/ navigationButtonSize = (width, height)
/ navigationButtonSize = (widthexpression, heightexpression)
/ nextButtonPosition = (x, y)
/ nextButtonPosition = (xexpression, yexpression)
/ nextLabel = label
/ orientation = layout
/ questions = [questionnumber, questionnumber = questionname; questionnumber-questionnumber = selectmode(questionname, questionname,...); questionnumber, questionnumber-questionnumber = questionname]
/ responseFontStyle = (name, height, bold, italic, underline, strikeout, quality, characterset)
/ showBackButton = boolean
/ showNextButton = boolean
/ showPageNumbers = boolean
/ showQuestionNumbers = boolean
/ subcaption = string
/ subcaptionFontStyle = (name, height, bold, italic, underline, strikeout, quality, characterset)
/ txColor = colorname
/ txColor = expression
/ draw = stimulusname
/ dropSources = (stimulus, stimulus, expression, expression, ...)
/ dropTargets = (stimulus, stimulus, expression, expression, ...)
/ inputMask = mask
/ 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 }
/ undoDraw = { script }
/ 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
</surveyPage>

Properties

Functions

surveyPage.name.clearStimulusFrames
surveyPage.name.insertStimulusFrame
surveyPage.name.insertStimulusTime
surveyPage.name.removeStimulusFrame
surveyPage.name.removeStimulusTime
surveyPage.name.resetStimulusFrames
surveyPage.name.setStimulusFrame
surveyPage.name.setStimulusTime
surveyPage.name.stimulusFrame
surveyPage.name.stimulusTime

Remarks

The surveypage element is a specialized type of trial that presents one or more survey questions. A survey page may be presented as part of a sequence of pages in a survey element, or it can be presented like as a trial trials in a block element.

Survey pages can present multiple choice, free text, and slider questions, as well as plain text, images, and even rapid sequences of stimuli (pictures, video, text, sound, port signals) just like regular trials.

Examples

The following surveypage displays three questions:

<surveypage myPage>
/caption = "Please answer the following items to the best of your ability"
/ questions=[1=q1; 2=q2; 3=q3]
</surveypage>

The following surveypage displays three questions, no back button, a custom label on the next button. At the end of the page, it sets a custom value based on the response to the first question.

<surveypage myPage>
/caption = "Please answer the following items to the best of your ability"
/ questions=[1=q1; 2=q2; 3=q3]
/ showBackButton=false
/ nextLabel="Forward"
/ onTrialEnd = { if (radioButtons.q1.response == 1) values.sex = "female";}
</surveypage>