TableColumnHeader Element

Cikk
09/17/2021

Defines the label, the width of the column, and the alignment of the label for a column of the table.

Schema

Configuration Element
ViewDefinitions Element
View Element
TableControl Element
TableHeaders Element
TableColumnHeader Element

Syntax

<TableColumnHeader>
  <Label>DisplayedLabel</Label>
  <Width>NumberOfCharacters</Width>
  <Alignment>Left, Right, or Centered</Alignment>
</TableColumnHeader>

Attributes and Elements

The following sections describe attributes, child elements, and the parent element of the TableColumnHeader element.

Attributes

None.

Child Elements

Element	Description
Label Element For TableColumnHeader for TableControl	Optional element. Defines the label that is displayed at the top of the column. If no label is specified, the name of the property whose value is displayed in the rows is used.
Width Element for TableColumnHeader for TableControl	Required element. Specifies the width (in characters) of the column.
Alignment Element for TableColumnHeader for TableControl	Optional element. Specifies how the label of the column is displayed. If no alignment is specified, the label is aligned on the left.

Parent Elements

Element	Description
TableHeaders Element	Defines the columns of a table view.

Remarks

Specify a header for each column of the table. The columns are displayed in the order in which the TableColumnHeader elements are defined.

A table must have the same number of TableColumnHeader elements as TableRowEntry elements. The column header defines how the text at the top of the table is displayed. The row entries define what data is displayed in the rows of the table.

For more information about the components of a table view, see Table View.

Example

The following example shows two TableColumnHeader elements. The first element defines a column whose label is "Column 1", has a width of 16 characters, and whose label is aligned on the left. The second element defines a column whose label is "Column 2", has a width of 10 characters, and whose label is centered in the column.

<TableHeaders>
  <TableColumnHeader>
    <Label>Column 1</Label)
    <Width>16</Width>
    <Alignment>Left</Alignment>
  </TableColumnHeader>
    <TableColumnHeader>
    <Label>Column 2</Label)
    <Width>10</Width>
    <Alignment>Centered</Alignment>
  </TableColumnHeader>
</TableHeaders>