Space is added as needed to accommodate the grid's scroll bars and any border or grid lines
This property enables you to apply CSS styles to the control when the program is run through AcuToWeb. The value of ATW-CSS-CLASS should represent a corresponding class in the current theme (that is, a .class-name entry in the cascading style sheet) deployed when you run your program through AcuToWeb. This property can be applied to more than one control in your program.
If both the ATW-CSS-CLASS and ATW-CSS-ID properties are specified for this control, and both correspond to the same style in the style sheet, the style specified by ATW-CSS-ID takes precedence.
See Cascading Style Sheet Syntax for more information about additional in-built styles in AcuToWeb.
This property enables you to apply CSS styles to the control when the program is run through AcuToWeb. The value of ATW-CSS-ID should represent a corresponding ID in the current theme ((that is, a #class-name entry in the cascading style sheet)) deployed when you run your program through AcuToWeb. The value of this property must be unique, and only applied to one control in your program.
If both the ATW-CSS-CLASS and ATW-CSS-ID properties are specified for this control, and both correspond to the same style in the style sheet, the style specified by ATW-CSS-ID takes precedence.
See Cascading Style Sheet Syntax for more information about additional in-built styles in AcuToWeb.
EVENT-LIST is an exclusive list of events that are either sent to or withheld (blocked) from the program depending on the value of EXCLUDE-EVENT-LIST. See Common Screen Options for more information.
| 3-D | Displays 3-D shading around the border of the control. |
| ADJUSTABLE-COLUMNS |
Allows the user to change the size of the columns by dragging the column dividers with the mouse. The grid must have only
one row per record for this style to have any effect. When the grid has column headers, the user will be able to change the
column widths only by dragging the header dividers (this is to reduce the likelihood of the user accidentally changing a column's
width when just clicking on a cell). If the grid does not have column headers, the user can drag any part of the divider.
The minimum column size is 1. The maximum is the visible portion of the grid. If the grid allows for horizontal scrolling, the VIRTUAL-WIDTH property will change as the user changes column sizes. When the user changes a column size, your program will be informed via a MSG-COL-WIDTH-CHANGED message. Because grids use integer character widths for measuring columns, the user will not be able to place the column divider at just any pixel location. The grid will adjust the location given by the user to the nearest character position Note: Single column grids are not adjustable (the column already occupies all of the grid's display space). If a single column
grid has the
ADJUSTABLE-COLUMNS property, the column may appear to be adjustable, but when the user releases the mouse after dragging to change the width,
the column will return to its original width.
|
| BOXED | Displays a border around the grid. If neither BOXED nor NO-BOX is specified, the default is machine-dependent. Under Windows, a box is displayed. |
| CENTERED-HEADINGS | Draws column headings centered, regardless of the alignment of the rest of the column. If this is not specified, the column headings match the alignment of the corresponding column. Note that the alignment of row headings is specified as the first entry in the ALIGNMENT property, so there is no need for any special row heading alignment styles. |
| COLUMN-HEADINGS | Causes the first record to be treated as column headers. See the discussion on headers above for details. |
| HSCROLL | Specifies a horizontally scrolling grid. A grid with this style may not specify more than one row per record (for more information, see the DISPLAY-COLUMNS special property). |
| NO-BOX | Causes the grid to display without a surrounding border. See the BOXED property. |
| NO-CELL-DRAG | Prevents the user from dragging a cell in a grid control. You can configure NO-CELL-DRAG style to be the default setting for grid controls by setting the GRID_NO_CELL_DRAG configuration variable to 1 (on, true, yes). The default value is 0 (off, false, no) and will enable the user to drag a cell in a grid control. |
| PAGED | Makes the grid a "paged" grid. Paged grids are typically used when the number of records in the grid is too many for a normal grid. When you set this style for a grid that contains data, records above the first visible record and records after the last visible record are deleted. See Paged Grids for a complete description of paged grids. |
| ROW-HEADINGS | Treats the first column of each record as a row header. Note that this is typically useful only when you have one record per row. See the discussion on headers above for more details. |
| TILED-HEADINGS |
Draws the headings with some shading that causes the headings to look like tiles. This gives a light 3-D look to the grid.
This style is effective only if the background color for the heading cells is low-intensity and not black. This looks best
if you set the heading's background color to low-intensity white (that is, gray) and set the heading's divider color to black.
Using the constants found in the COPY library
acucobol.def, you can most easily specify this with:
HEADING-COLOR = BCKGRND-WHITE, HEADING-DIVIDER-COLOR = BLACK |
| USE-TAB | Causes the grid to use the Tab and Backtab keys as navigation keys within the grid. Without this style, the Tab and Backtab keys move between the grid and other controls in the grid's window. |
| VSCROLL | Specifies a vertical scroll bar for the grid. Grids without vertical scroll bars may still contain more records than seen on the screen, and the user can still reach these records using the keyboard. The usual reason for creating a grid without a vertical scroll bar is if you are going to limit the number of records to an amount that fits on the screen (see NUM-ROWS below). |