VGridControlBase.RowHeaderWidth Property

Gets or sets the width of row headers.

Namespace : DevExpress.XtraVerticalGrid

Assembly : DevExpress.XtraVerticalGrid.v25.2.dll

NuGet Packages : DevExpress.Win.Navigation, DevExpress.Win.VerticalGrid

Declaration

C#
VB.NET

csharp

[XtraSerializableProperty(XtraSerializationFlags.AutoScaleX)]
public int RowHeaderWidth { get; set; }

<XtraSerializableProperty(XtraSerializationFlags.AutoScaleX)>
Public Property RowHeaderWidth As Integer

Property Value

Type	Description
Int32

An integer value which specifies the width of row headers.

Remarks

The RowHeaderWidth and VGridControlBase.RecordWidth properties specify the widths of row headers and records respectively, in either absolute values (pixels) or relative values.

Absolute values are used when:

The Multiple Records View Layout is applied to the vertical grid.
The Bands View Layout is applied, and the BaseOptionsView.AutoScaleBands option is disabled.

Relative values are used when row headers and the current record are stretched to fit the control’s width. This happens in the following cases:

The Single Record View Layout is applied to the vertical grid.
The Bands View Layout is applied, and the BaseOptionsView.AutoScaleBands option is enabled.

In these latter modes, each of the RowHeaderWidth and VGridControlBase.RecordWidth properties can be set to a value in the range [15;185]. The other property’s value is calculated by subtracting this value from 200. So, the sum of the properties is always equal to the constant value of 200. The absolute widths will be proportional to the specified relative values.

In addition, resizing the control horizontally in these modes modifies the width of row headers accordingly. To prevent row headers from being resized, set the BaseOptionsView.FixRowHeaderPanelWidth property to true.

Changing the RowHeaderWidth property’s value raises the VGridControlBase.RowHeaderWidthChanged event.