surveypage element

The surveypage element presents a page of survey questions.

Syntax

<surveypage surveypagename>
/ backbuttonposition = (x value, y value)
/ backlabel = "label"
/ branch = [if expression then event]
/ caption = "text"
/ datastreams = (eyetracker) or eyetracker or false
/ finishlabel = "label"
/ fontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ inputmask = "bit mask"
/ itemfontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ itemspacing = height or expression
/ navigationbuttonfontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ navigationbuttonsize = (width variable, height variable)
/ nextbuttonposition = (x value, y value)
/ nextlabel = "label"
/ numframes = integer
/ ontrialbegin = [expression; expression; expression; ...]
/ ontrialend = [expression; expression; expression; ...]
/ orientation = layout
/ posttrialpause = integer expression
/ posttrialsignal = (modality, signal) or (mouse, stimulusname) or (mouse, mouseevent)
/ pretrialpause = integer expression
/ pretrialsignal = (modality, signal) or (mouse, stimulusname) or (mouse, mouseevent)
/ questions = [questionnumber, questionnumber = questionname; questionnumber-questionnumber = selectmode(questionname, questionname,...); questionnumber, questionnumber-questionnumber = questionname]
/ recorddata = boolean
/ responsefontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ screencapture = boolean
/ showbackbutton = boolean
/ shownextbutton = boolean
/ showpagenumbers = boolean
/ showquestionnumbers = boolean
/ skip = [expression; expression; expression; ...]
/ soundcapture = boolean
/ 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; ...]
/ subcaption = "text"
/ subcaptionfontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ timeout = integer expression
/ txcolor = (red value, green value, blue value) or color name or color value
</surveypage>

Properties

Functions

surveypage.surveypagename.clearstimulusframes
surveypage.surveypagename.insertstimulusframe
surveypage.surveypagename.insertstimulustime
surveypage.surveypagename.removestimulusframe
surveypage.surveypagename.removestimulustime
surveypage.surveypagename.resetstimulusframes
surveypage.surveypagename.setstimulusframe
surveypage.surveypagename.setstimulustime
surveypage.surveypagename.stimulusframe
surveypage.surveypagename.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>