WinForms PropertyGrid Overview

When RadPropertyGrid is not in read-only mode users can edit the contents of the selected item. Usually this process starts by pressing Enter or F2 key. All of the following conditions should be met to put an item in edit mode:

Telerik UI for WinForms Ninja image

The Editors is part of Telerik UI for WinForms, a professional grade UI library with 160+ components for building modern and feature-rich applications. To try it out sign up for a free 30-day trial.

  • The underlying data source supports editing.

  • RadPropertyGrid control is enabled.

  • BeginEditMode property value is not BeginEditProgrammatically.

  • ReadOnly property of the control is set to false.

  • The item the user wants to edit is enabled.

  • The ReadOnly property of item the user wants to edit is set to false.

When in edit mode, the user can change the item value and press Enter to commit the change or Esc to revert to the original value. Clicking outside the edited item also commits the change.

You can configure RadPropertyGrid so that items enter edit mode directly when the item is selected or when users press F2 or Enter or click for a second time on the item without triggering a double click event. The BeginEditMode property controls this behavior.

There are a number of build-in ediotrs which are used for editing different data types. These editors can be customized or can be replaced by custom editors all together. Here is a list of the build-in ediotrs and the data types they are used for:

PropertyGridBrowseEditor Used for editing of type image.
PropertyGridColorEditor Used for editing of type color.
PropertyGridDateTimeEditor Used for editing of type DateTime.
PropertyGridDropDownListEditor Used for editing of types that have a type converter supporting standart values and do not have a UITypeEditor.
PropertyGridSpinEditor Used for editing of numeric data types.
PropertyGridTextBoxEditor Used for editing all data types that are not covered by other editors.
PropertyGridUITypeEditor Used for editing data types that have a UITypeEditor and are not covered by other editors.

Since R3 2017 PropertyGridSpinEditor supports null values. Detailed information is available here.

API Demonstrates how to control the editing process programmatically.
Events Demonstrates all events that occur during this process.
Data validation Demonstrates how to validate data in RadPropertyGrid.
Customizing editor behavior Demonstrates how to change editor behavior.
Using custom editors Demonstrates how to replace the standard editors with a custom one.
Handling editor events Demonstrates how to handle editor events.

See Also

In this article