OutlineStyle Attribute
Data Type: integer
4GL Access: RW
The OutlineStyle attribute (with OutlineWidth and OutlineColor) determines the appearance of an ActiveField's outline.
Valid values include:
OS_DEFAULT
Provides a default outline style that varies depending on the field type
OS_SOLID
Provides a solid outline
OS_3D
Provides a three-dimensional outline. In many cases, the last three outline styles provide better results.
OS_STANDARD
Provides an outline (or border) that varies with the field type. The OutlineWidth and OutlineColor attributes are ignored with this outline style. This outline style is designed to provide the most appropriate border for each field type. For some field types, there may be a two-pixel border that gives a raised appearance; for others, there may be no border at all. When there is a border, the border is drawn using standard Windows colors.
With this OutlineStyle, the field's background and foreground colors should be set to CC_SYS_BTNFACE and CC_SYS_BTNTEXT, respectively.
OS_RAISED
Provides a two-pixel border that gives a field a raised appearance. The border is drawn using standard Windows colors, and the OutlineColor and OutlineWidth attributes are ignored.
Note: This outline style is available only for StackFields and Subforms.
With this OutlineStyle, the field's background and foreground colors should be set to CC_SYS_BTNFACE and CC_SYS_BTNTEXT, respectively.
OS_SUNKEN
Provides a two-pixel border that gives a field a sunken appearance. The border is drawn using standard Windows colors, and the OutlineColor and OutlineWidth attributes are ignored.
Note: This outline style is available only for StackFields and Subforms.
With this OutlineStyle, the field's background and foreground colors should be set to CC_SYS_BTNFACE and CC_SYS_BTNTEXT, respectively.
OS_GROUPBOX
Provides a one-pixel border that gives a field a rounded appearance. The border is drawn using the OutlineColor, and the OutlineWidth attribute is ignored.
Note: This outline style is available only for Subforms where the GroupBoxLabel is defined. Since the effect of a GroupBoxLabel setting is to move the top border and bottom border inwards, Subforms with GroupBoxLabels cannot be aligned with Subforms without GroupBoxLabels when the frame's SnapToGrid is set. To ensure alignment, give the unlabeled Subform a GroupBoxLabel of a single space (" "); its border will be drawn as for a labeled Subform but with no break for the text.
OS_SHADOW
(Deprecated) Although available, this style is obsolete and should not be used.
OS_FLAT (OptionFields only)
Draws over the innate border associated with OptionFields with the current OutlineColor. If the OutlineColor is set to that of the underlying frame, the innate border disappears, making the OptionField appear flat. If another color is used, the innate border appears with the chosen color. The OS_FLAT OutlineStyle is independent of the OutlineWidth.
Descriptions of system constant values and their numeric equivalents are listed in
OutlineStyle Settings.