Programmer's Reference
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.
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]