Label property: GridColumn class

Description

This property specifies the display label for the GridColumn object, as distinct from the grid column’s Record Field Name or Page Field Name. This property overrides the equivalent settings on the Label tab of the grid column’s Page Field Properties.

Note:

You can't use this property to set labels longer than 100 characters. If you try to set a label of more than 100 characters, the label is truncated to 100 characters. If you change the column label, then change the field label, you may overwrite the column label with the field label. The grid object is part of a page, not the data buffers, while the field is part of the data buffers. To avoid this problem, always put any changes to column labels in the Activate event. This way the label is set every time the page is accessed.

This property is read/write.

Example

&MYGRIDCOLUMN.Label = "Checklist Item";

The LabelColumns and SetProperties methods of the Grid class can provide a noticeable performance improvement over multiple calls to set the Label property of the GridColumn class.