CTableColumn Properties

accessibilityDescription

If you have activated accessibility, the assigned text is added to the quick info. This description provides semantic details of the UI element, and is only read by the screen reader if the user focuses the complete Ul element. This property can be personalized by administrators.

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 specifes 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. Consider 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.

columnDragInfo

ID of DragSourceInfo (from aggregation DRAG_SOURCE_INFOS of the table) that applies to the column. For more information, see Drag&Drop with CTable.

columnDropInfo

Name or ID of DropTargetInfo (from the DROP_ROW_TRG_INFOSaggregation of the table) that applies to the column. For more information, see Drag&Drop with CTable.

columnEdgeDropInfo

Name or ID of DropTargetInfo (from the DROP_ROW_TRG_INFOS aggregation of the table) that applies to a drop before or after the column. For more information, see Drag&Drop with CTable.

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.

contextMenuBehaviour

Assignment of the context menu Note that the context menu can be overwritten in the hook method WDDOONCONTEXTMENU in all cases.

Value	Description
inherit	The UI element inherits the static context menu from its parent UI elements.
provide	The UI element context menu is the one which was specified by the contextMenuID.
suppress	No static context menu is created.

contextMenuId

ID for the context menu you have defined. You assign this ID to a UI element if the element itself and all the subelements below it are to get this context menu. For example, if you have defined a contextMenuId for a table, the context menu applies to the whole table and to all subelements.

fixedPosition

Specifies whether a CTableColumn is fixed on the left or right, or not fixed. The following values can be set in personalization:

left
notFixed
right

This property can be personalized by administrators.

hAlign

Horizontal alignment of the cell content

headerHAlign

Horizontale alignment of the column header. Default: Left

headerStyleClassName

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.

rowGroupingValue

When rows in this column with the same rowGroupingValue are bound, they are displayed in one cell. This means the TableCellEditor is displayed only once on the height of the first row, and only one shared border is shown.

selectedCellVariant

This property specifes 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)

visible

Visibility of the interface element. Both users and administrators can personalize this property.

Values	Description	Can be Set Using Personalization
NONE	The UI element is not visible on the screen and takes up no space.	Yes
VISIBLE	The UI element is displayed on the screen.	No

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.