The
displayName property
specifies the label that is displayed next to the field:
- In relation to a field in a PageHandler, you assign a string literal that
is used as a default label when you place the field (or a record that includes
the field) on the Web Page in Page Designer.
- In relation to VGUIRecord parts in programs of type VGWebTransaction,
you assign a string literal that is used as the label of the control in the
generated JSP file.
If you set
displayName for a structure-field
array in a VGUIRecord part, the following statements apply:
- If the string literal includes the newline character ("\n"), each successive
line of text is the label for the sequentially next element in the array.
An example of such a literal is as follows:
"label one:\nlabel two:\nlabel three:"
In
this example, the first array element receives the label label one:,
the second receives the label label two:, and the third receives label
three:.
- If you specify a string that does not include the newline character, that
string is used as the label for each array element.
- If you specify a string that has fewer lines than are needed to match
each element in the array, the last label that you provided is repeated for
each array element that was not assigned a label.
- If you specify a string that has more lines than are needed, the extra
labels are ignored.