load_virtual_display

Syntax

load_virtual_display [<line>] "<pri_string>" [<wrap>] "<sec_string>" <keyword_parms>;

Terse form

lvd

Parameters

Adds the defined string to the virtual display.

Description

• <line> is the line number to be written (optional). If omitted, the line number increments from the last explicitly defined line number.
• <pri_string> is a character string to be written to the primary column.
• <wrap> is an optional parameter to set or reset the wrap indicator. Use && to set the wrap indicator, and || to reset it. You can also set and reset the wrap indicator using the 'wi=' keyword parameter.
• <sec_string> is a character string to be written to the secondary column.
• <keyword_parms> are a number of optional keyword parameters which take defaults according to the most common usage. These are:

  "page=i" (default), or "page=c"

  Defines which page to use.

  "wi=0" (default), or "wi=1"

  Wrap indicator.

  "ss=0" (default), or "ss=1"

  Section start indicator.

  "lrci=l" (default), "lrci=r", "lrci=c", or "lrci=i"

  Formatting flags.

  "hi=xyy,xyy,xyy,xyy"

  Defines highlight mode control:

  x

  One of n, r, g, or b (normal, reverse, gray, or bold)

  yy

  The column number

  "sk?=xxx" (?=1..6), "skg=xxx" and "skl=xxx"

  where:

  xxx

  A definer specified in the same way as for the initialise_soft_key_table statement (for example, hf12).

  "sk1=" ... "sk6="

  The definers to be used for softkeys 1 through 6.

  "skg"

  The GPALD definer, executed whenever this line becomes the active line.

  "skl"

  The LSBLD definer, executed when the user attempts to scroll beyond a logical section of the display page.

References

TR-NWT-001273.

Notes

• Text passed from the application state table can be substituted in either the primary or the secondary string by preceding the argument name corresponding to the input parameter with a dollar sign.