3-D Displays 3-D shading around the border of the control.
(create, modify)
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, then 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's accidentally changing a column's width when just clicking on a cell). If the grid does not have column headers, then 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, then 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. (create, modify)
BOXED Displays a border around the grid. If neither BOXED nor NO-BOX is specified, then the default is machine-dependent. Under Windows, a box is displayed. (create, modify)
CENTERED-HEADINGS Draws column headings centered, regardless of the alignment of the rest of the column. If this is not specified, then 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. (create, modify)
COLUMN-HEADINGS Causes the first record to be treated as column headers. See the discussion on headers above for details. (create, modify)
HSCROLL Specifies a horizontally scrolling grid. A grid with this style may not specify more than one row per record (see DISPLAY-COLUMNS below). (create, modify)
NO-BOX Causes the grid to display without a surrounding border. See BOXED. (create, modify)
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 Chapter 3, section 3.10 for a complete description of paged grids. (create, modify)
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. (create, modify)
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 (i.e., 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
(create, modify)
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. (create, modify)
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). (create, modify)