up Inquisit Language Reference

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)
/ pretrialpause = integer expression
/ pretrialsignal = (modality, signal)
/ 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)
/ showbackbutton = boolean
/ showpagenumbers = boolean
/ showquestionnumbers = boolean
/ 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, ...)]
/ subcaption = "text"
/ subcaptionfontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ timeout = integer expression
/ trialcode = "string"
/ txcolor = (red value, green value, blue value) or color name or color value
</surveypage>

Properties

surveypage.surveypagename.backlabel
surveypage.surveypagename.caption
surveypage.surveypagename.correct
surveypage.surveypagename.correctcount
surveypage.surveypagename.correctstreak
surveypage.surveypagename.count
surveypage.surveypagename.currentquestionnumber
surveypage.surveypagename.error
surveypage.surveypagename.errorcount
surveypage.surveypagename.errorstreak
surveypage.surveypagename.finishlabel
surveypage.surveypagename.fontheight
surveypage.surveypagename.inputmask
surveypage.surveypagename.inwindow
surveypage.surveypagename.itemfontheight
surveypage.surveypagename.itemspacing
surveypage.surveypagename.latency
surveypage.surveypagename.leftmargin
surveypage.surveypagename.maxlatency
surveypage.surveypagename.meanlatency
surveypage.surveypagename.medianlatency
surveypage.surveypagename.minlatency
surveypage.surveypagename.name
surveypage.surveypagename.navigationbuttonheight
surveypage.surveypagename.navigationbuttonwidth
surveypage.surveypagename.nextlabel
surveypage.surveypagename.numinwindow
surveypage.surveypagename.percentcorrect
surveypage.surveypagename.percentinwindow
surveypage.surveypagename.posttrialpause
surveypage.surveypagename.pretrialpause
surveypage.surveypagename.response
surveypage.surveypagename.responsefontheight
surveypage.surveypagename.rightmargin
surveypage.surveypagename.sdlatency
surveypage.surveypagename.showbackbutton
surveypage.surveypagename.showpagenumbers
surveypage.surveypagename.showquestionnumbers
surveypage.surveypagename.subcaption
surveypage.surveypagename.subcaptionfontheight
surveypage.surveypagename.sumlatency
surveypage.surveypagename.topmargin
surveypage.surveypagename.totalcorrectcount
surveypage.surveypagename.totalcount
surveypage.surveypagename.totalerrorcount
surveypage.surveypagename.totalmaxlatency
surveypage.surveypagename.totalmeanlatency
surveypage.surveypagename.totalmedianlatency
surveypage.surveypagename.totalminlatency
surveypage.surveypagename.totalnuminwindow
surveypage.surveypagename.totalpercentcorrect
surveypage.surveypagename.totalpercentinwindow
surveypage.surveypagename.totalsdlatency
surveypage.surveypagename.totalsumlatency
surveypage.surveypagename.totaltrialcount
surveypage.surveypagename.totalvarlatency
surveypage.surveypagename.trialcode
surveypage.surveypagename.trialcount
surveypage.surveypagename.trialduration
surveypage.surveypagename.typename
surveypage.surveypagename.varlatency

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>

Send comments on this topic:
Copyright Millisecond Software, LLC. All rights reserved.