itemnext

Identifies the next item on the page, excluding the global item. An item is next when it appears next in the build order (in other words, it is next in the XFDL text).

This option is not saved or transmitted as part of the form. Instead, it is automatically created each time the form is read into memory, and is maintained only during display or processing.

Syntax

   <itemnext>item reference</itemnext>

Available In

action, box, button, cell, check, checkgroup, combobox, data, field, help, label, line, list, popup, radio, radiogroup, richtext, signature, slider, spacer, toolbar

Example

The following example shows what two labels look like in memory, with the itemnext option inserted in each:

   <label sid="LABEL2">
      <value>This is a label.</value>
      <itemnext>LABEL3</itemnext>
   </label>
   <label sid="LABEL3">
      <value>This is a label.</value>
      <itemnext>LABEL4</itemnext>
   </label>

You can use computes to determine the next item on the form. For example, the following code shows a label that uses a compute set its value. The compute goes to the item that currently has the focus, then copies the value of the itemnext option from that item:

   <label sid="nextItemName">
      <value compute="PAGE1.global.focuseditem->itemnext"></value>
   </label>

Usage details

1. Defaults: none
2. If the itemnext option is in the last item on the page, it points to the first item on the page (excluding the global item).
3. When the itemnext option is used in items that appear in table rows:
   • Each item points to the next item in the row.
   • The last item in the row points to the first item in the next row.
   • The last item in the table it points to the first item following the table.
4. When working with panes, tables, radiogroups, or checkgroups:
   • The item that precedes a table, pane, radiogroup, or checkgroup points to the table, pane, radiogroup, or checkgroup.
   • The last item generated by a pane, table, radiogroup, or checkgroup points to the first item following the containing item.
5. The itemnext option is not saved or transmitted with form descriptions.