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

C#

public DefaultCrossTabControl DefaultCrossTabControl { get; set; }

VB.NET

Public Property DefaultCrossTabControl As DefaultCrossTabControl

Property Value

Type	Description
DefaultCrossTabControl	The control to display cross-tab data.

Available values:

Name	Description
XRCrossTab	The XRCrossTab control.
XRPivotGrid	The XRPivotGrid control.

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.

C#

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

VB.NET

Friend NotInheritable Class Program
    Private Sub New()
    End Sub
    Shared Sub Main()
        DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.DefaultCrossTabControl = 
           DevExpress.XtraReports.UI.DefaultCrossTabControl.XRPivotGrid
        ' ...
    End Sub
End Class

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.