---
title: Row Header and Cell Layout Options
order: 840
seealso: []
---


# Row Header and Cell Layout Options

The [`PropertyGridControl`](https://eremexcontrols.net/API/Eremex.AvaloniaUI.Controls.PropertyGrid/PropertyGridControl/index.md) provides several properties to control the width of the caption (header) column and the editor (cell) column, and to specify the alignment of row headers. You can fix the width of these columns, and allow users to resize them at runtime.

## Set Column Widths

Use the following properties to set the widths of PropertyGrid columns:

- [`CaptionColumnWidth`](https://eremexcontrols.net/API/Eremex.AvaloniaUI.Controls.PropertyGrid/PropertyGridControl/CaptionColumnWidth/index.md) — Gets or sets the width of the header (caption) column. Defaults to a `GridLength.Star` value.
- [`EditorColumnWidth`](https://eremexcontrols.net/API/Eremex.AvaloniaUI.Controls.PropertyGrid/PropertyGridControl/EditorColumnWidth/index.md) — Gets or sets the width of the editor (cell) column. Defaults to a `GridLength.Star` value.

    ![propertygrid-columns-caption-and-editor-widths](https://eremexcontrols.net/images/propertygrid-columns-caption-and-editor-widths.png)


The [`CaptionColumnWidth`](https://eremexcontrols.net/API/Eremex.AvaloniaUI.Controls.PropertyGrid/PropertyGridControl/CaptionColumnWidth/index.md) and [`EditorColumnWidth`](https://eremexcontrols.net/API/Eremex.AvaloniaUI.Controls.PropertyGrid/PropertyGridControl/EditorColumnWidth/index.md) properties accept a `GridLength` value, so you can specify an absolute pixel width, a star (proportional) width, or an auto width.

The default values of these properties are `GridLength.Star`, which means the available horizontal space is divided proportionally between the caption and editor columns.


If you use absolute (pixel) widths for both columns, ensure that their sum does not exceed the width of the control. Otherwise, the column content will be trimmed.

```csharp
propertyGridControl.Width = 300;
propertyGridControl.CaptionColumnWidth = new GridLength(100);
propertyGridControl.EditorColumnWidth = new GridLength(200);
```


## Allowing Users to Resize Columns

PropertyGrid allows users to resize the caption and editor columns at runtime using the built-in resizer.

![propertygrid-resizer](https://eremexcontrols.net/images/propertygrid-column-resizer.gif)

Use the [`AllowResizing`](https://eremexcontrols.net/API/Eremex.AvaloniaUI.Controls.PropertyGrid/PropertyGridControl/AllowResizing/index.md) property to control whether the resizer is enabled. The property's default value is `true`.


## Aligning Caption Text

Use the [`CaptionHorizontalAlignment`](https://eremexcontrols.net/API/Eremex.AvaloniaUI.Controls.PropertyGrid/PropertyGridControl/CaptionHorizontalAlignment/index.md) property to specify the horizontal alignment of the text within the caption column. The following text alignment modes are supported: `Left`, `Center` and `Right`.

```csharp
propertyGridControl.CaptionHorizontalAlignment = HorizontalAlignment.Center;
```