BaseOptionsView.ShowRootCategories Property

Gets or sets whether top-level category rows are visible.

Namespace: DevExpress.XtraVerticalGrid

Assembly: DevExpress.XtraVerticalGrid.v19.2.dll

Declaration

C#

[DefaultValue(true)]
[XtraSerializableProperty]
public virtual bool ShowRootCategories { get; set; }

VB.NET

<DefaultValue(True)>
<XtraSerializableProperty>
Public Overridable Property ShowRootCategories As Boolean

Property Value

Type	Default	Description
Boolean	**true**	true, if root category rows are visible; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type	Path to ShowRootCategories
PropertyGridControl	.OptionsView.ShowRootCategories
VGridControl	.OptionsView.ShowRootCategories
VGridControlBase	.OptionsView.ShowRootCategories

Remarks

If the ShowRootCategories property is set to false top-level category rows are not displayed and regular rows that belong to the category rows are arranged as a linear list in alphabetical order. In addition, in this mode, the Property Grid Control doesn’t permit rows to be rearranged using drag and drop or in code. For more information on runtime row reordering ,see the Using Drag and Drop topic.

Hiding root category rows is generally useful for the PropertyGridControl.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ShowRootCategories property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-share-a-single-barmanager-between-different-usercontrols-e1927/CS/B143239/PropertiesUserControl.cs#L47

    alphabeticalItem.Checked = false;
    propertyView.OptionsView.ShowRootCategories = true;
} else if (sender == alphabeticalItem) {

how-to-create-a-propertygrid-toolbar-that-allows-users-to-sort-and-categorize-properties-e504/CS/Form1.cs#L54

void UpdatePropertyGrid() {
    this.propertyGridControl.OptionsView.ShowRootCategories = this.barButtonCategorized.Down;
}

VB.NET

how-to-share-a-single-barmanager-between-different-usercontrols-e1927/VB/B143239/PropertiesUserControl.vb#L53

    alphabeticalItem.Checked = False
    propertyView.OptionsView.ShowRootCategories = True
ElseIf sender Is alphabeticalItem Then

how-to-create-a-propertygrid-toolbar-that-allows-users-to-sort-and-categorize-properties-e504/VB/Form1.vb#L62

Private Sub UpdatePropertyGrid()
    Me.propertyGridControl_Renamed.OptionsView.ShowRootCategories = Me.barButtonCategorized.Down
End Sub