PropertyGridControl.CustomExpand Event
Enables you to control how properties and categories expand.
Namespace: DevExpress.Xpf.PropertyGrid
Assembly: DevExpress.Xpf.PropertyGrid.v24.2.dll
NuGet Package: DevExpress.Wpf.PropertyGrid
#Declaration
#Event Data
The CustomExpand event's data class is CustomExpandEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
Handled |
Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.
Inherited from Routed |
Is |
Gets or sets whether the item is expanded. |
Is |
Gets whether the item is being initialized. |
Original |
Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.
Inherited from Routed |
Routed |
Gets or sets the Routed |
Row | Gets information about an expanding row. |
Source |
Gets or sets a reference to the object that raised the event.
Inherited from Routed |
The event data class exposes the following methods:
Method | Description |
---|---|
Invoke |
When overridden in a derived class, provides a way to invoke event handlers in a type-specific way, which can increase efficiency over the base implementation.
Inherited from Routed |
On |
When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes.
Inherited from Routed |
#Remarks
Handle the CustomExpand event to expand a row (or category). This event fires for each PropertyGridControl item. Set the event arguments’ CustomExpandEventArgs.IsExpanded property to true to expand a processed item.
When the CustomExpandEventArgs.IsExpanded property is set to true, end-users cannot collapse items in the PropertyGridControl. Set the IsExpanded property to true only if the processed item is initializing (CustomExpandEventArgs.IsInitializing is true) to allow end-users to collapse the control items.
The code sample below demonstrates how to expand all the items within the control and allow end-users to collapse them:
void PropertyGridControl_CustomExpand(object sender, CustomExpandEventArgs args) {
if(args.IsInitializing)
args.IsExpanded = true;
}