UserDesignerOptions.DefaultCrossTabControl Property

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

Namespace : DevExpress.XtraReports.Configuration

Assembly : DevExpress.XtraReports.v25.2.dll

NuGet Package : DevExpress.Reporting.Core

Declaration

C#
VB.NET

csharp

public DefaultCrossTabControl DefaultCrossTabControl { get; set; }

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#
VB.NET

csharp

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

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.