Skip to main content

UserDesignerOptions.DefaultCrossTabControl Property

Specifies the default control used to present cross-tab data (XRCrossTab or XRPivotGrid).

Namespace: DevExpress.XtraReports.Configuration

Assembly: DevExpress.XtraReports.v24.1.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

public DefaultCrossTabControl DefaultCrossTabControl { get; set; }

Property Value

Type Description
DefaultCrossTabControl

The control to display cross-tab data.

Property Paths

You can access this nested property as listed below:

Object Type Path to DefaultCrossTabControl
ReportingSettings
.UserDesignerOptions .DefaultCrossTabControl
Settings
.UserDesignerOptions .DefaultCrossTabControl

Remarks

The DefaultCrossTabControl option is in effect only for the Visual Studio Report Designer and WinForms End-User Report Designer.

In Visual Studio at design time, you can access this option in the Report Designer Options dialog.

To specify the default control to present cross-tab data in the WinForms End-User Report Designer, set the DefaultCrossTabControl option at the application’s startup.

static class Program {
    static void Main() {
        DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.DefaultCrossTabControl = 
            DevExpress.XtraReports.UI.DefaultCrossTabControl.XRPivotGrid;
        // ...
    }
}

The table below describes how this option affects reports and the Report Designer’s tools.

Feature

DefaultCrossTabControl = XRCrossTab

DefaultCrossTabControl = XRPivotGrid

Support in Reports

You can use both XRCrossTab and XRPivotGrid controls in a report regardless of the DefaultCrossTabControl property value.

Toolbox

The Toolbox contains the XRCrossTab.

The Toolbox contains the XRPivotGrid.

Cross-Tab Report Wizard

The Report Wizard contains the Cross-Tab Report option.

The Report Wizard does not support cross-tab reports.

Conversion

You can convert the XRPivotGrid to the XRCrossTab.

If the conversion result does not suit your requirements, you can restore the original XRPivotGrid.

You cannot convert XRCrossTab and XRPivotGrid to each other.

See Also