Client Table (CTable)

In addition to the standard properties of the classic Web Dynpro Table, the Web Dynpro Client Table or CTable has various complex properties, which are listed in the table below. The figure below illustrates a CTable:

Figure 1: CTable

Complex Features of CTable

The table below contains a list of the CTable features:

Feature	Description
Set the height of the CTable	A special feature of the CTable is the display of the automatic height of the table according to the size of the browser window. The number of visible rows can also be set using the Handle (sash) at the bottom of the table. For more information, see CTable Properties.
Vertical and horizontal scrolling with asynchronous reload	You can scroll horizontally and vertically in the CTable. With vertical scrolling the contents of the table are reloaded asynchronously as you scroll.
Specify cell design	You can find a list of options for designing the cell in CTableColumn.
Cell editors	You can find a list of available cell editors in Cell Editors in the CTable. For more information about using the TextEdit UI element as the cell editor, see Editing Text in a Table or CTable.
Cell variants	You can choose between the following cell variants: Cell Variant to Define Cells with Fixed Positions Hierarchical cell variant MultiEditor Cell Variant Standard cell variant SymbolCell Variant
Drag and drop	For more information, see Drag&Drop in the CTable.
Fix columns, cells or rows	In a CTable you can specify a fixed position of columns. Columns can be positioned left or right in the table. Furthermore, with the UI element CTableFixedCell the position of cells in the table can be fixed. Cells can be fixed at the top or bottom of a column. To fix the position of a row at the top or bottom, you have to specify the fixed position of each single cell of that row. For more information, see CTableFixedCell. You can move columns and rows by drag and drop (notFixed) (see Drag & Drop in the CTable).
Deactivate implicit personalization	You can deactivate implicit personalization. Settings like number of rows, column width, and sort order can be saved by the application or framework. For more information, see Personalization Mode.
Display CTable with pager	You can display the CTable with a pager. For more information, see CTable with Pager.
Menu	With this UI element you can create a personalized menu for each column header of the CTable. For more information, see Menu.
Selection behavior	The CTable has a different selection behavior. While the classic table sets the lead selection automatically, with the CTable only that what has been explicitly selected is actually selected.

Note

Do not use the CTable if you want to display a large number of columns in your table. While the number of rows is not important, a large number of columns can reduce performance. If you need a large number of columns, we recommend you use the classic Table.

CTable Details

Runtime Class:

CL_WD_C_TABLE

Properties in View Designer

Name	Type	Initial Value	Bindable
id	STRING	(automatic)	No
activateAccessKey	WDY_BOOLEAN	false	No
cellStyleClassNames	WDR_CELL_STYLE_CLASS_NAMES		Yes
columnHeaderDropInfo	STRING		Yes
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	No
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		No
dataSource	Context Node		Mandatory
dataSourceBottomFixs	Context node		Yes
dataSourceTopFixed	Context node		Yes
emptyTableText	Translatable text		Yes
enabled	WDY_BOOLEAN	true	Yes
firstVisibleRow	I	1	Yes
gridMode	WDUI_TABLE_GRID_MODE	both	Yes
headerRowHeight	I		Yes
heightMode	WDUI_C_TABLE_HEIGHT_MODE	useVisibleRowCount	Yes
legendID	WDY_MD_UI_ELEMENT_REFERENCE		Yes
navigationMode	WDUI_C_TABLE_NAVIGATION_MODE	scrollbar	Yes
personalizationMode	WDUI_C_TABLE_PERS_MODE	framework	Yes
readOnly	WDY_BOOLEAN	false	Yes
rowDragInfo	STRING		Yes
rowDropInfo	STRING		Yes
rowEdgeDropInfo	STRING		Yes
rowHeight	I		Yes
rowSelectable	WDY_BOOLEAN	true	Yes
scrollbarVisibility	WDUI_SCROLLBAR_VISIBILITY	Standard	Yes
selectionColumnDesign	WDUI_C_TABLE_SEL_COL_DESIGN	default	Yes
selectionMode	WDUI_C_TSMODE	singleNoLead	Yes
styleClassName	STRING		Yes
tableBodyDropInfo	STRING		Yes
textMarkers	WDR_C_TABLE_TEXT_MARKERS		Yes
tooltip	Translatable text		Yes
transparencyMode	WDUI_C_TABLE_TRANSPARENCY_MODE	none	Yes
visible	WDUI_VISIBILITY	visible	Yes
visibleRowCount	I	5	Yes
width	STRING		Yes

Aggregations in the View Designer

Name	Cardinality	Type
COLUMNS	0..n	AbstrCTableColumn
DRAG_SOURCE_INFOS	0..n	DragSourceInfo
DROP_TARGET_INFOS	0..n	DropTargetInfo
HEADER_AREA	0..1	CTableHeaderArea
SCROLL_TIP_PROVIDER	0..1	TableScrollTipProvider
Toolbar	0..1	ToolBar

Events in View Designer

Name
onDrop
onRowCreate
onSelect

Use

Note

Other properties that can be inherited are defined in the related higher-level classes. The related UI elements are:

Dynamic Programming

For dynamic programming, the same properties, events, and aggregations as in the View Designer are available. But note that the spelling format and use of upper/lower case is different.

View Designer Name	Runtime Name	Type
activateAccessKey	ACTIVATE_ACCESS_KEY	WDY_BOOLEAN
cellStyleClassNames	CELL_STYLE_CLASS_NAMES	WDR_CELL_STYLE_CLASS_NAMES
columnHeaderDropInfo	COLUMN_HEADER_DROP_INFO	STRING
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_C_TABLE=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_C_TABLE=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_C_TABLE=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
dataSource	DATA_SOURCE	OBJECT
dataSourceBottomFixed	DATA_SOURCE_BOTTOM_FIXED	OBJECT
dataSourceTopFixed	DATA_SOURCE_TOP_FIXED	OBJECT
emptyTableText	EMPTY_TABLE_TEXT	WDY_MD_TRANSLATABLE_TEXT
enabled	ENABLED	WDY_BOOLEAN
firstVisibleRow	FIRST_VISIBLE_ROW	I
gridMode	GRID_MODE	WDUI_TABLE_GRID_MODE
gridMode: both	CL_WD_C_TABLE=>E_GRID_MODE-BOTH
gridMode: horizontal	CL_WD_C_TABLE=>E_GRID_MODE-HORIZONTAL
gridMode: none	CL_WD_C_TABLE=>E_GRID_MODE-NONE
gridMode: vertical	CL_WD_C_TABLE=>E_GRID_MODE-VERTICAL
headerRowHeight	HEADER_ROW_HEIGHT	I
heightMode	HEIGHT_MODE	WDUI_C_TABLE_HEIGHT_MODE
heightMode: allRows	CL_WD_C_TABLE=>E_HEIGHT_MODE-ALL_ROWS
heightMode: useAvailableHeight	CL_WD_C_TABLE=>E_HEIGHT_MODE-AUTO_VERTICAL
heightMode: useVisibleRowCount	CL_WD_C_TABLE=>E_HEIGHT_MODE-VISIBLE_ROW_COUNT
heightMode: useVisibleRowCountNoResize	CL_WD_C_TABLE=>E_HEIGHT_MODE-VISIBLE_ROW_COUNT_NO_RESIZE
legendID	LEGEND_ID	WDY_MD_UI_ELEMENT_REFERENCE
navigationMode	NAVIGATION_MODE	WDUI_C_TABLE_NAVIGATION_MODE
navigationMode: pager	CL_WD_C_TABLE=>E_NAVIGATION_MODE-PAGER
navigationMode: scrollbar	CL_WD_C_TABLE=>E_NAVIGATION_MODE-SCROLLBAR
personalizationMode	PERSONALIZATION_MODE	WDUI_C_TABLE_PERS_MODE
personalizationMode: application	CL_WD_C_TABLE=>E_PERSONALIZATION_MODE-APPLICATION
personalizationMode: framework	CL_WD_C_TABLE=>E_PERSONALIZATION_MODE-FRAMEWORK
readOnly	READ_ONLY	WDY_BOOLEAN
rowDragInfo	ROW_DRAG_INFO	STRING
rowDropInfo	ROW_DROP_INFO	STRING
rowEdgeDropInfo	ROW_EDGE_DROP_INFO	STRING
rowHeight	ROW_HEIGHT	I
rowSelectable	ROW_SELECTABLE	WDY_BOOLEAN
scrollbarVisibility	SCROLLBAR_VISIBILITY	WDUI_SCROLLBAR_VISIBILITY
scrollbarVisibility: onHover	CL_WD_C_TABLE=>E_SCROLLBAR_VISIBILITY-ON_HOVER
scrollbarVisibility: standard	CL_WD_C_TABLE=>E_SCROLLBAR_VISIBILITY-STANDARD
selectionColumnDesign	SELECTION_COLUMN_DESIGN	WDUI_C_TABLE_SEL_COL_DESIGN
selectionColumnDesign: default	CL_WD_C_TABLE=>E_SELECTION_COLUMN_DESIGN-DEFAULT
selectionColumnDesign: none	CL_WD_C_TABLE=>E_SELECTION_COLUMN_DESIGN-NONE
selectionMode	SELECTION_MODE	WDUI_C_TSMODE
selectionMode: multiNoLead	CL_WD_C_TABLE=>E_SELECTION_MODE-MULTI
selectionMode: none	CL_WD_C_TABLE=>E_SELECTION_MODE-NONE
selectionMode: singleNoLead	CL_WD_C_TABLE=>E_SELECTION_MODE-SINGLE
styleClassName	STYLE_CLASS_NAME	STRING
tableBodyDropInfo	TABLE_BODY_DROP_INFO	STRING
textMarkers	TEXT_MARKERS	WDR_C_TABLE_TEXT_MARKERS
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
transparencyMode	TRANSPARENCY_MODE	WDUI_C_TABLE_TRANSPARENCY_MODE
transparencyMode: cellDesignStandard	CL_WD_C_TABLE=>E_TRANSPARENCY_MODE-CELL_DESIGN_STANDARD
transparencyMode: cellDesignTransparent	CL_WD_C_TABLE=>E_TRANSPARENCY_MODE-CELL_DESIGN_TRANSPARENT
transparencyMode: none	CL_WD_C_TABLE=>E_TRANSPARENCY_MODE-NONE
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_C_TABLE=>E_VISIBLE-NONE
visible: visible	CL_WD_C_TABLE=>E_VISIBLE-VISIBLE
visibleRowCount	VISIBLE_ROW_COUNT	I
width	WIDTH	STRING

View Designer Name	Runtime Name
onDrop	ON_DROP
onRowCreate	ON_ROW_CREATE
onSelect	ON_SELECT

View Designer Name	Runtime Name	Cardinality
COLUMNS	COLUMNS	0..n
DRAG_SOURCE_INFOS	DRAG_SOURCE_INFOS	0..n
DROP_TARGET_INFOS	DROP_TARGET_INFOS	0..n
HEADER_AREA	HEADER_AREA	0..1
SCROLL_TIP_PROVIDER	SCROLL_TIP_PROVIDER	0..1
TOOLBAR	TOOLBAR	0..1

More Information

You can find an example in the system in component WDR_TEST_C_TABLE.

For more information about the classic Web Dynpro table, see Table.