nextvalue property

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

Member of

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 sometext>
/ items= ("nextvalue = <% text.sometext.nextvalue %>")
</text>

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

<page somepage>
nextvalue = <% text.sometext.nextvalue %>
</page>