[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Collapse]Property Grid
   [Expand]Getting Started
   [Expand]Property Definitions
    Property Attributes
    Property Categories
    Expandability Customization
    Property Menu
   [Expand]Visual Elements
    Appearance Customization
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Expandability Customization

Expanded Overview

The PropertyGrid control allows you to customize property expandability in the following ways.

Expanded Customizing Property Expandability at the Control Level

The following PropertyGrid properties affect the expandability behavior.


The PropertyDefinition.AllowExpanding property has higher precedence than the PropertyGridControl.AllowExpanding property.

The following table lists the available AllowExpanding property values and corresponding expandability modes.


property value

Property grid expandability behavior


Expands properties according to their type converters.


Expands all properties.


Expands all properties that don't have a type converter.


Properties are not expandable.

The following example demonstrates the AllowExpanding property precedence.

Expanded Customizing Property Expandability at the Model Level

To control property expandability from the model, use the System.ComponentModel.TypeConverter attribute.


A type converter affects the expandability if the AllowExpanding property is set to Default or ForceIfNoTypeConverter.


To learn more about the property attributes supported by the PropertyGrid control, see Property Attributes.

Expanded See Also

Is this topic helpful?​​​​​​​