PropertyGridDockPanel.ShowCategories Property
Gets or sets a value indicating whether to show categories for the items in the Properties window, or show them in alphabetical order.
Namespace: DevExpress.XtraReports.UserDesigner
Assembly: DevExpress.XtraReports.v24.2.Extensions.dll
NuGet Package: DevExpress.Win.Reporting
#Declaration
[DefaultValue(true)]
[SRCategory(ReportStringId.CatBehavior)]
public bool ShowCategories { get; set; }
#Property Value
Type | Default | Description |
---|---|---|
Boolean | true | true to show categories; false to sort alphabetically. |
#Remarks
The following images illustrate how this property works.
Show |
Show |
---|---|
![]() |
![]() |
#Example
This example illustrates how to access and customize the Report Designer’s dock panels.
Note
All the Report Designer’s dock panels inherit their settings from the Design
For this reason, you need to reference the DevExpress.
using DevExpress.XtraBars.Docking;
using DevExpress.XtraReports.UI;
using DevExpress.XtraReports.UserDesigner;
// ...
private void button1_Click(object sender, System.EventArgs e) {
// Create a Design Tool with an assigned report instance.
ReportDesignTool designTool = new ReportDesignTool(new XtraReport1());
// Access the standard or ribbon-based Designer form and its MDI Controller.
// IDesignForm designForm = designTool.DesignForm;
IDesignForm designForm = designTool.DesignRibbonForm;
// Access and hide the Group and Sort panel.
GroupAndSortDockPanel groupSort =
(GroupAndSortDockPanel)designForm.DesignDockManager[DesignDockPanelType.GroupAndSort];
groupSort.Visibility = DockVisibility.AutoHide;
// Access and hide the Report Explorer.
ReportExplorerDockPanel reportExplorer =
(ReportExplorerDockPanel)designForm.DesignDockManager[DesignDockPanelType.ReportExplorer];
reportExplorer.Visibility = DockVisibility.AutoHide;
// Access and hide the Report Gallery.
ReportGalleryDockPanel reportGallery =
(ReportGalleryDockPanel)designForm.DesignDockManager[DesignDockPanelType.ReportGallery];
reportGallery.Visibility = DockVisibility.AutoHide;
// Access the Properties window and customize some of its settings.
PropertyGridDockPanel propertyGrid =
(PropertyGridDockPanel)designForm.DesignDockManager[DesignDockPanelType.PropertyGrid];
propertyGrid.ShowCategories = false;
propertyGrid.ShowDescription = false;
// Access the Field List and customize some of its settings.
FieldListDockPanel fieldList =
(FieldListDockPanel)designForm.DesignDockManager[DesignDockPanelType.FieldList];
fieldList.ShowNodeToolTips = false;
fieldList.ShowParametersNode = false;
// Load a Report Designer in a dialog window.
// designTool.ShowDesignerDialog();
designTool.ShowRibbonDesignerDialog();
}