![[property icon]](bitmaps/browsetool21.png)
ColSize
ColSize
ColSize
Selects how column width is determined
Enumerated type, possible values are:
| Default | Grid default rules |
|---|---|
| Type | The width is based on the Type property of the column. Nearly all data types, such as D (date), T (time), Np.s (numeric) and In (integer) display all values with the same width. For small strings (S1, S2 and S3) the width is based on the largest single character (often, but not necessarily 'W'). For larger string types the average character width is used |
| Header | The width is based on the Type property of the column. However if the header string in the Heading$ property is wider, then the width of the header is used instead |
| Largest | The column is sized to the largest entry. This means that no text will be truncated. This is the most computationally intensive of the options but this will not be a problem except in very large grids |
| Stretch | The column will be at least its default width wide. After sizing all other column types if there is room for the grid to be wider without creating a horizontal scroll bar, then all columns that can stretch are widened proportional to make the grid as wide as possible |
| Automatic | Where there is a Type property and it is not a long string then Header column sizing is used, otherwise Stretch is used. |
| StretchNumeric | Behave like Stretch but do not size below the widest numeric value including thousands separators and sign. |
| FitNumeric | Do not size below the widest numeric value including thousands separators and sign. |
Introduced in KCML version 6.00
The ColSize property is used to specify how columns can be automatically sized according to their content. This is a cell based property, although it only has an effect if applied to a column. It is possible to set a grid-wide column sizing property which used on columns that have default sizing. For instance the following example will set the column sizing to be based on type for all columns except column 5 which is based on the largest entry.
.gridControl1.Cell(0, 5).ColSize = &.Largest .gridControl1.ColSize = &.Type