CTableColumn Properties

  • cellBorderOmitting

    This property specifies whether the right (horizontal), the lower (vertical), or both borders are not available. To omit the borders of individual cells, this property must be bound to a context attribute (beneath the DATA_SOURCE of the table).

  • cellDesign

    This property defines the background color of the table cell. You can find the valid values under WDUI_TABLE_CELL_DESIGN. The cellDesign can be used at column level and at cellVariant level. The value of cellVariant is retrieved and used for cellDesign. If no value for cellVariant exists, the system checks whether a cellDesign value exists at column level, which can then be used instead.

  • cellMerging

    This property specifies whether a cell can be merged across multiple columns.

    Value Description
    useNextFreeCells The cells of this column are merged with all the next cells that have the value freeCell.

    freeCell

    		 The cells of this column are merged with other cells horizontally. This property in the previous CTableColumn must have the value useNextFreeCells.

    none

    		 The cells of this column cannot be merged with other cells.

    Example:

    In a table with four columns, you want to merge the cells of the first three columns horizontally. Set the cellMerging property of CTableColumns to the following values:
    • CTableColumn 1: useNextFreeCells
    • CTableColumn 2: freeCell
    • CTableColumn 3: freeCell
    • CTableColumn 4: none

    If you want to define cell merging differently for each row, bind this property to a context attribute. Note the following restrictions:

    • In the default mode of Internet Explorer 9, merged cells can only be correctly displayed if there is at least one cell within the segment that is not merged horizontally with other cells.
    • You can only merge cells that are within a segment.

    You can find an example in application WDR_TEST_C_TABLE in the test case Merging Cells.

  • cellVisibility

    Hides or shows a cell.

  • columnResizable

    This property specifies whether the size of a column can be changed by a user (inplace with drag & drop). This property depends on the personalization of the end user and can be deactivated with application parameter WDDISABLEUSERPERSONALIZATION.

  • colSelectionState

    Selection status of the column; valid values are notSelectable, notSelected and selected.

  • headerHAlign

    Horizontal alignment of the column header Default: Left

  • headerStyleClassName
  • hAlign

    Horizontal alignment of the cell content

  • isFiltered

    Specifies whether a filter icon is displayed in the column heading. This indicates that the current table entries are filtered according to values in this TableColumn.

  • selectedCellVariant

    This property specifies the active table cell variants for a table cell. The variant whose variantKey matches with selectedCellVariant. If the value is set to initial, no cell variant is used, instead the properties of the table column itself and its TableCellEditor are used. An invalid selectedCellVariant is not allowed.

  • sortState

    This property describes how a table column is sorted. The data in the table is not automatically displayed sorted by the sortState property and the onSort event; the application itself must sort the data.

  • state

    Specifies whether the column is to be flagged as "required" (column header is preceded with an asterisk)

  • width

    Width of the table column; %, em, ex, or px This property can be personalized both by the user and the administrator.

    • If the column width of one column is specified as a percentage, horizontal scrolling is not possible. If the width of all columns is specified as a percentage, horizontal scrolling is possible. The sum of all width specifications should not be more than 100%.

    • If you want to specify the column width in different units, make sure that you specify first the columns whose widths you want to specify in pixels, em and ex, and then distribute the available table width to the remaining columns in percentages.