nextValue property

The next-selected value of a standalone list item or a stimulus list.

Member of

Syntax

object.name.nextValue

Read Only

Type

value

Remarks

A new value is selected according to the selectionRate setting. If the selectionRate is set to "always", for example, this property selects a new value from the list everyTime it is accessed. If selectionRate is "trial", a new value is selected the first time the property is accessed on a given trial, and the same value is returned every subsequent time the property is accessed on that trial.

To retrieve the current value without causing a new value to be selected, see the currentValue property.

This property is a synonym for the obselete "selectedValue" property.

Examples

The following displays the value of nextValue in a text stimulus:

<text myText>
/ items= ("nextValue = <% text.myText.nextValue %>")
</text>

The following displays the value of nextValue in an instruction page:

<page myPage>
nextvalue = <% text.myText.nextValue %>
</page>