)ATTRS
Specifies the field attributes that display in the BODY section.
Type
Placeholder
Format
)ATTRS [RESET]
'c' TYPE(type) COLOR(color) DISPLAY(display) HIGHLIGHT(highlight)
'c' TYPE(type) COLOR(color) DISPLAY(display) HIGHLIGHT(highlight)
'c' TYPE(type) COLOR(color) FORMAT(MIX) NOUPPER(noupper)
'c' TYPE(type) COLOR(color) FORMAT(MIX) SOSI(sosi)
.
.
.- RESET
- Resets all previously defined attributes, including those set by the )BODY placeholder.
- c
- Specifies the field attribute character, enclosed in single quotes.
- type
- Specifies the field type attribute:
- INPUT
- Specifies the start of an input (unprotected) field.
- NUMERIC
- Specifies the start of a numeric field.
- OUTPUT
- Specifies the start of an output field.
- SKIP
- Specifies the start of a non-input field skipped over by the cursor.
- color
- Specifies the field color attribute:
- BLUE
- The default color for field type. This is the same as not specifying color.
- GREEN
- PINK
- RED
- TURQUOISE
- WHITE
- YELLOW
- display
- Specifies the field display attribute:
- HIGH
- High intensity, detectable by a selector pen.
- INVISIBLE
- Non-display, not detectable by a selector pen.
- NORMAL
- Normal intensity, not detectable by a selector pen.
- SELECT
- Normal intensity, detectable by a selector pen.
- highlight
- Specifies the field display attribute:
- format
- Specifies the character set field attribute:
- SBCS
- Indicates single-byte character set.
- DBCS
- Indicates double-byte character set.
- MIX
- Indicates mixed character set.
- noupper
- Specifies translation to uppercase.
- YES
- Do not translate SBCS characters to uppercase.
- NO
- Translate SBCS characters to uppercase.
- sosi
- Specifies SOSI character usage.
- YES
- SOSI characters will be included in the datastream.
- NO
- SOSI characters will not be included in the datastream.
Usage Notes®
- The terminal must support extended attributes for color and highlight. If the terminal does not support extended attributes, the Presentation Space Manager removes them before transmission.
- )ATTRS begins with the default attribute characters available with the )BODY placeholder. )ATTRS adds to or overrides the defaults.
- An attribute character set by )ATTRS can be cleared with )ATTRS RESET, which resets all attributes.
- When the BODY section is compiled, the )ATTRS placeholder in effect at that time is used to build the panel. You can code additonal ATTRS sections between )BODY TOP, )BODY CENTER, )BODY TABLE, and )BODY BOTTOM to add or modify attribute characters. An )ATTRS placeholder coded after the BODY section has no affect on the construction of the panel.
- Defining field attributes in the ATTRS section and the BODY section is mutually exclusive. Coding a field attribute in the BODY section (PI, PN, and so forth) deletes all field attributes defined in the ATTRS section, and the default attributes provided with )BODY are reestablished with any modifications that you made to them. The )ATTRS placeholder is the preferred method for defining field attributes because they are easier to manage.
- The asterisk (*) is used to imbed comments in the ATTRS section. Place an * at the beginning of a line and follow it with text that comments on the attribute. Text following an asterisk is ignored by the Dialog Manager.
- The noupper option is considered only if UPPERCASE folding is active for the dialog panel. See UPPERDLG initialization statement, and CASE dialog statement.
- Specifying the SOSI option will cause SOSI characters to be included in outbound datastreams, and to be preserved in inbound datastreams.
Example
)ATTRS sets the semicolon (;) to
mark the start of a red, high intensity, pen-selectable, blinking
input field:
)attrs
; type(input) color(red) display(high) highlight(blink)
)ATTRS sets character (#) to mark the start of a red, MIX, input
field with SO/SI characters in the presentation space buffer :
)attrs
# type(input) color(red) format(mix)