Skip to main content

TcxvgOptionsView.ValueWidth Property

Specifies the width of data cells in pixels.

Declaration

property ValueWidth: Integer read; write; default 100;

Property Value

Type Default Description
Integer 100

The data cell width, in pixels.

Remarks

Use this property to adjust the width of data cells.

Use the ValueWidth property to specify the width of data cells in pixels. This property affects the data cell width if the value of the TcxVirtualVerticalGrid.LayoutStyle property is lsBandsView or lsMultiRecordView and the value of the TcxvgOptionsView.AutoScaleBands property is False. If this value is insufficient to display data in cells entirely then text clipping may occur.

If the value of the TcxvgOptionsBehavior.BandSizing property is True and the value of the TcxVirtualVerticalGrid.LayoutStyle property is lsMultiRecordView the user can drag the right edge of the first data column to resize the width of all data columns in the grid.

If you attempt to assign the ValueWidth property value less than specified by the ValueMinWidth property, the ValueMinWidth property value will be assigned.

If the value of the AutoScale property is True and the value of the TcxVirtualVerticalGrid.LayoutStyle property is lsBandsView the grid control automatically adjusts the band’s width to the width of the control client area. In this case the value of the ValueWidth property is ignored. If the value of the ShowHeaders property is False the grid control automatically enlarge the band’s width to fit the width of the control client area. In this case the value of the ValueWidth property is ignored.

If the value of the TcxVirtualVerticalGrid.LayoutStyle property is lsSingleRecordView the grid control automatically adjusts the data column width to the width of the control client area. In this case the value of the ValueWidth property is ignored. If the value of the ShowHeaders property is False the grid control automatically enlarge the data column width to fit the width of the control client area. In this case the value of the ValueWidth property is ignored.

The default ValueWidth property value is 100.

See Also