Version 6.3.8 for Windows
 —  Dialog Component Reference  —

Table Control

This document covers the following topics:


Description

A table control is a dialog element representing a spreadsheet. It provides an optional header row for naming the columns and an optional left column for naming the rows.

Once the table control has defined the spreadsheet as such, the columns are defined by adding column-specification controls. The cells of the table control are not defined as dialog elements but are identified by the values of the table control's COLUMN and ROW attributes. The first cell is identified by ROW =1 and COLUMN =1. The cells of each column may be used differently depending on the value of the column specification control's COLUMN-TYPE attribute: they may be used as input fields, selection boxes with items or toggle buttons.

You manipulate table controls with a set of PROCESS GUI statement actions.

Top of page

Attributes for Table Control

Attribute Name Query Set/Modify In Attr. Window
BACKGROUND-COLOUR-NAME X X/X X
BACKGROUND-COLOUR-VALUE X X/X X
CELL-ATTRIBUTES X X/X  
CLIENT-DATA X X/X  
CLIENT-HANDLE X X/X  
CLIENT-KEY X X/X  
CLIENT-VALUE X X/X  
COLUMN X -/X  
COLUMN-COUNT X X/-  
CONTEXT-MENU X X/X X
DIL-TEXT X X/X X
ENABLED X X/X X
FIRST-CHILD X -/-  
FIRST-COLUMN-WIDTH X X/X X
FIRST-VISIBLE-COLUMN X X/X X
FIRST-VISIBLE-ROW X X/X X
FOLLOWS X X/X  
FONT-HANDLE X X/X X
FOREGROUND-COLOUR-NAME X X/X X
FOREGROUND-COLOUR-VALUE X X/X X
FROZEN-COLUMNS X X/X X
HAS-FIRST-COLUMN X X/- X
HEADER-FONT-HANDLE X X/X X
HEADER-HEIGHT X X/X X
HELP-ID X X/X X
HORIZ-SCROLLABLE X X/- X
LAST-CHILD X -/-  
MODIFIABLE X X/- X
MODIFIED X -/X  
MODIFIED-SUCCESSOR X -/-  
OWNER X X/-  
PARENT X X/-  
PREDECESSOR X -/-  
RECTANGLE-H X X/X X
RECTANGLE-W X X/X X
RECTANGLE-X X X/X X
RECTANGLE-Y X X/X X
ROW X -/X  
ROW-COUNT X X/- X
ROW-HEIGHT X X/X X
RTL X -/- X
STYLE X X/- X
SUCCESSOR X X/-  
SUPPRESS-CHANGE-EVENT X -/-  
SUPPRESS-CLICK-EVENT X X/X  
SUPPRESS-DBL-CLICK-EVENT X X/X  
SUPPRESS-DELETE-ROW-EVENT X X/X  
SUPPRESS-ENTER-EVENT X X/X  
SUPPRESS-ENTER-CELL-EVENT X X/X  
SUPPRESS-FILL-EVENT X X/X  
SUPPRESS-INSERT-ROW-EVENT X X/X  
SUPPRESS-LEAVE-EVENT X X/X  
SUPPRESS-LEAVE-CELL-EVENT X X/X  
SUPPRESS-TOP-EVENT X X/X  
TOOLTIP X X/X  
TYPE X X/-  
VERT-SCROLLABLE X X/- X
VISIBLE X X/X X

Top of page

Attributes for Cells in a Table Control

Attribute Name Query Set/Modify In Attr. Window
BACKGROUND-COLOUR-NAME X X/X  
BACKGROUND-COLOUR-VALUE X X/X  
CHECKED X X/X  
COLUMN X X/X  
DIL-TEXT X X/X  
FOREGROUND-COLOUR-NAME X X/X  
FOREGROUND-COLOUR-VALUE X X/X  
ROW X X/X  
STRING X X/X  

Top of page

COLUMN-TYPEs in Cells and their Attributes

The attributes that are valid for cells in table controls in general are not always available depending on the value of the column specification control's attribute COLUMN-TYPE. Such a value might be, for example, "input field control". The cell can then be used like an input field control. For this input-field cell, only a subset of the attributes is available.

The following table specifies which attributes are not applicable to specific COLUMN-TYPE.

COLUMN-TYPE Attributes NOT Available
Input field control CHECKED
Selection box control CHECKED
Toggle button control STRING

Top of page

Events

Change Event, Click Event, Delete Row Event, Double Click Event, Enter Event, Enter-Cell Event, Fill Event, Insert-Row Event, Leave Event, Leave-Cell Event, Top Event (all events may be suppressed).

The following events are not always triggered:

Top of page