Table list resources

To use all of a table list's features, an application must set resources and callbacks for the table list widget and for its individual columns.

The columns of the table list widget are defined by the columns resource that should be set to a collection of EwTableColumn instances. The resources that can be set for each column are described in "Table columns".

The table list widget supports the standard selection policies, plus additional policies for cell selection.

Standard selection policies

Additional policies for cell selection

XmSINGLESELECT

Standard selection policies apply to the rows in the table as a whole

XmEXTENDEDSELECT

Standard selection policies apply to the rows in the table as a whole

XmMULTIPLESELECT

Standard selection policies apply to the rows in the table as a whole

XmBROWSESELECT

Standard selection policies apply to the rows in the table as a whole

XmCELLSINGLESELECT

Allows individual cells to be selected

XmCELLBLOCKSELECT

Allows contiguous blocks of rows to be selected

The table list selection policies involve a separate protocol. Messages such as selectPos:notify: and deselectAllItems are used with the standard policies. Messages such as selectCell:notify: and deselectCell: are used with the cell selection policies. It is important to ensure that the protocol being used at any given time is appropriate for the widget's selection policy. Row selection methods should not be used with cell selection policies and vice versa.

Many resources affect the visual appearance of the table:

visualStyle

Specifies whether the rows or individual cells should have an etched, three dimensional appearance

headingSeparatorThickness

Controls the appearance of the line between column headings and the rows of cell values

headingVisualStyle

Specifies whether the column heading should have an etched, three dimensional appearance

rowSeparators

Specifies whether lines should be drawn between each row

separatorsToExtremes

Specifies whether row separators should stop at the last column or continue to the border of the widget

lockedColumns

Specifies the number of columns that should be locked on the left-hand side. When a column is locked, it does not scroll when the list is scrolled horizontally. This allows certain anchor columns to always remain visible, such as an icon or name column.

editable

Specifies whether the cell values in the table can be edited. This can be controlled for each individual column. Editing is discussed in Direct editing of cell values and Edit policies.