Identifying screen-arrays in ui.Dialog methods

In ui.Dialog methods such as setCurrentRow(), the first parameter is the name of the screen array to identify the list container in the form.

Screen arrays are defined in form specification files with the SCREEN RECORD clause, and used in DISPLAY ARRAY and INPUT ARRAY instructions to bind program array variables to the list container.

In the form file:

LAYOUT
...
INSTRUCTIONS
SCREEN RECORD custlist ( ... );
END
In the program code:
DISPLAY ARRAY custarr TO custlist.*
   ...
   ON ACTION set_row
      CALL DIALOG.setCurrentRow("custlist", row_index)
   ...

The name of the screen array passed as parameter can use the same letter case as in the SCREEN RECORD definition: The lookup is case-insensitive:

-- In the form file:
SCREEN RECORD CustList ( ... );
-- In the program code:
CALL DIALOG.setCurrentRow("CustList", row_index)