Class

DesktopTableColumn

Table Column

Description

The width attributes of a single column of a DesktopTable.

An instance is never created by the application: it is handed out by DesktopTable.ColumnAttributesAt or by iterating DesktopTable.Columns. The object holds no state of its own - it keeps a weak reference to its table and forwards every access to it. Passing DesktopTable.AllColumns (-1) yields an object whose setters apply to every column.

Widths are expressed as a point value ("100"), a percentage ("25%") or a relative share ("*", "2*"). An invalid expression raises an UnsupportedFormatException.

Properties

Name	Type	Read-Only	Shared
MaxWidthActual	Integer
MaxWidthExpression	String
MinWidthActual	Integer
MinWidthExpression	String
UserResizable	Boolean
Visible	Boolean
WidthActual	Integer
WidthExpression	String

Property descriptions

DesktopTableColumn.MaxWidthActual

MaxWidthActual As Integer

Resolved maximum width in points. Maximum column width in points. It is the resolved value of MaxWidthExpression, so a percentage is already turned into points.

This example sets the resolved maximum width in points:
Table1.ColumnAttributesAt(1).MaxWidthActual = 0

DesktopTableColumn.MaxWidthExpression

MaxWidthExpression As String

Maximum width as an expression. Maximum column width as an expression (points, % or *). It caps the column while the user drags it wider and while a share (*) or percentage grows.

This example sets the maximum width as an expression:
Table1.ColumnAttributesAt(1).MaxWidthExpression = "MaxWidthExpression"

DesktopTableColumn.MinWidthActual

MinWidthActual As Integer

Resolved minimum width in points. Minimum column width in points. It is the resolved value of MinWidthExpression, so a percentage is already turned into points.

This example sets the resolved minimum width in points:
Table1.ColumnAttributesAt(1).MinWidthActual = 0

DesktopTableColumn.MinWidthExpression

MinWidthExpression As String

Minimum width as an expression. Minimum column width as an expression (points, % or *). It keeps the column from becoming narrower, however the width is computed.

This example sets the minimum width as an expression:
Table1.ColumnAttributesAt(1).MinWidthExpression = "MinWidthExpression"

DesktopTableColumn.UserResizable

UserResizable As Boolean

Whether the user may drag this column's width. With False the divider next to the column cannot be dragged, even while the table allows resizing.

This example sets whether the user may drag this column's width:
Table1.ColumnAttributesAt(1).UserResizable = True

DesktopTableColumn.Visible

Visible As Boolean

Whether the column is shown - same as ColumnVisibleAt. A hidden column keeps its data, its width expressions and its index. It only takes no space, raises no paint events and cannot be hit, resized, dragged or edited.
Table1.ColumnAttributesAt(1).Visible = False

DesktopTableColumn.WidthActual

WidthActual As Integer

Resolved current width in points. Current column width in points. It is what the layout made of WidthExpression, bounded by the minimum and maximum. A hidden column reports 0.

This example sets the resolved current width in points:
Table1.ColumnAttributesAt(1).WidthActual = 0

DesktopTableColumn.WidthExpression

WidthExpression As String

Current width as an expression. Column width as an expression (points, % or *).
Var col As DesktopTableColumn = Table1.ColumnAttributesAt(1)

col.WidthExpression = "*"
col.MinWidthActual = 80
col.MaxWidthActual = 400

Compatibility

Project Types	Desktop
Operating Systems	All