Show TOC Start of Content Area

Object documentation TableColumn  Locate the document in its SAP Library structure

Definition

A Table is built of TableColumns. You have to insert a TableCellEditor into each TableColumn.

Note

As of NetWeaver 7.0 (2004s), the association role of TableColumns has changed from Columns to GroupedColumns. You can migrate tables to the new association role using the Migrate Columns function in the context menu of the Table UI element.

 

Description of Properties

      accessibilityDescription

When accessibility is activated, the assigned text is added to the tooltip. 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.

      cellDesign

This specifies the color of the TableColumn. The cellDesignproperty is represented by enumeration type WDTableCellDesign.

For the enumeration values see: WDTableCellDesign

      colSelectionState

This specifies the selection state of the column. This property can be set by the application developer – for example, when the user triggers the onAction event. colSelectionState can have the following values and is represented by enumeration type WDTableColumnSelectionState.

       notSelectable

       notSelected

       selected

      design

This property is deprecated. Use cellDesign instead.

      explanation

This determines the explanation text. More information: Explanation

      filterValue

You can use this property to define the value to be filtered and to bind it to a corresponding context attribute.

      fixedPosition

This specifies whether a table column is fixed on the left or right. fixedPosition is represented by enumeration type TableColumnFixedPosition and can have the following values:

left

The column is fixed on the left.

notFixed

The column is not fixed and can be scrolled.

right

The column is fixed on the right.

      groupingValue

This specifies the table column that is used to group the values.  The user can identify the grouping by the fact that the same values of a column are only displayed in the column in which they are listed for the first time and by the fact that there is no separator between the cells of the grouped values.

This graphic is explained in the accompanying text

      hAlign

This describes the horizontal alignment of the table column. The hAlign property is represented by the enumeration type WDTableColumnHAlign and can have the following values:

auto

Automatic alignment of the text content. The alignment is specified by the usage of the UI element - for example, by the data type of the value to be represented.

beginOfLine

The text content is always displayed at the beginning of the line. Therefore, the text content for the value ltr of the textDirection property is left-justified. The text content for the value rtl is right-justified.

center

Center alignment.

endOfLine

The text content is always displayed at the end of the line. Therefore, the text content for the value ltr of the textDirection property is right-justified. The text content for the value rtl is left-justified.

forcedLeft

The text content is always left-justified, regardless of whether the value is ltr or rtl for the textDirection property.

forcedLRight

The text content is always right-justified, regardless of whether the value is ltr or rtl for the textDirection property.

left

Left-justified alignment. This value is deprecated. Use beginOfLine instead.

right

Right-justified alignment. This value is deprecated. Use forcedRight instead.

The default value for this property is auto.

      headerTextWrapping

This specifies whether the header text wraps.

      isFiltered

This specifies whether the values of the column are filtered and the filter icon is displayed in the column's header.

      resizable

This specifies whether the width of the table column can be modified by the user.

      selectedCellVariant

This specifies the selected cell variant.

      sortState

This specifies the sort status of the table column. sortState is represented by enumeration type TableColumnSortDirection and can have the following values:

down

The table column is sorted in descending order.

none

The table column is not sorted, but can be sorted.

notSortable

The table column cannot be sorted.

up

The table column is sorted in ascending order.

      visible

This property specifies the visibility of the UI element. The default value for this property is visible.

       visible. The UI element is displayed on the screen.

       none. The UI element is not visible on the screen and takes up no space.

       notYet. The UI element is not yet visible in its view and is treated like NONE. It can be made visible by personalization. This can be used to ship hidden parts of a screen that can then be made visible on demand.

       always. A UI element is always visible and cannot be hidden by personalization.

       blank. The UI element is not visible on the screen but takes up space.

This graphic is explained in the accompanying text

This value should not be used for security reasons. Use none instead.

      width

This determines the width of the table column. You can specify it in relative CSS units such as em, ex, or percentage.

More information: Common UI Element Properties

Properties Overview

Name

Interface

Type

Initial Value

Bindable

accessibilityDescription

IWDAbstractTableColumn

String

 

bindable

cellDesign

IWDTableColumn

TableCellDesign

standard

bindable

colSelectionState

IWDTableColumn

WDTableColumnSelectionState

notSelectable

bindable

design

IWDTableColumn

CellBackgroundDesign

transparent

bindable

explanation

IWDAbstractTableColumn

String

 

not_bindable

filterValue

IWDTableColumn

String

 

bindable

fixedPosition

IWDAbstractTableColumn

TableColumnFixedPosition

notFixed

bindable

groupingValue

IWDTableColumn

String

 

bindable

hAlign

IWDTableColumn

TableColumnHAlign

auto

bindable

headerTextWrapping

IWDAbstractTableColumn

boolean

false

bindable

isFiltered

IWDTableColumn

boolean

false

bindable

resizable

IWDTableColumn

boolean

true

bindable

selectedCellVariant

IWDTableColumn

String

 

bindable

sortState

IWDTableColumn

TableColumnSortDirection

none

bindable

visible

IWDAbstractTableColumn

Visibility

visible

bindable

width

IWDTableColumn

String (CSS size)

 

bindable

Events

      onAction (String col)

This event is deprecated. Use onColSelect or onSort of Table instead

End of Content Area