Breaking Changes in v2010 vol 1.5

This page lists important behavior and API changes, which were introduced in this version. If you already have projects using DXperience, you will need to peruse this list in order to understand the changes you might need to make to your source code to support this new release.

Note that we only publish the changes to the public interface of our controls. We reserve the right to change the protected, internal, or private interfaces when needed.

Table of Contents

• AgRichEdit
• eXpressApp Framework
• PivotGrid Core
• XtraCharts Suite
• XtraEditors Library
• XtraGrid Suite
• XtraPivotGrid Suite
• XtraReports Suite

AgRichEdit

• BC727: The DevExpress.Utils.Commands.ICommandUIState interface now implements an additional property - EditValue.

eXpressApp Framework

• BC729: DXPropertyEditor - The GetDisplayText method has been removed.

  If you need to provide a custom display text for an editor, override the SetupRepositoryItem method and handle the RepositoryItem.CustomDisplayText event.

• BC725: IModelOptionsWin - The RibbonControlStyle property has been moved to the OptionsRibbon child node.

  Previously, the IModelOptionsWin interface exposed the RibbonControlStyle property:
  
  

  [C#]

  public interface IModelOptionsWin : IModelNode {
    //...
    RibbonControlStyle RibbonControlStyle { get; set; }
    //...
}
  
  
  Now, the RibbonControlStyle property has been moved to the newly added IModelOptionsRibbon child node:
  
  

  [C#]

  public interface IModelOptionsWin : IModelNode {
    //...
    IModelOptionsRibbon OptionsRibbon { get; }
    //...
}

public interface IModelOptionsRibbon : IModelNode{
    RibbonControlStyle RibbonControlStyle { get; set; }
    bool MinimizeRibbon { get; set; }

}

PivotGrid Core

• BC529: Some classes have been moved from DevExpress.XtraPivotGrid.Data to DevExpress.XtraPivotGrid namespace

  These classes' namespace has been changed fromDevExpress.XtraPivotGrid.Data to DevExpress.XtraPivotGrid:
  * PivotGridOptionsPrint
  * PivotGridPageSettings
  * PivotGridOptionsViewBase
  * PivotGridOptionsChartDataSourceBase
  * PivotGridCustomSummaryEventArgsBase
  * PivotOLAPKPIValue
  * PivotOLAPKPIMeasures
  * IOLAPMember

• BC550: The behavior of the ASPxPivotGrid.CustomCellValue and CustomCellDisplayText events has been changed.

  ASPxPivotGrid.CustomCellValue and CustomCellDisplayText events aren't called on postbacks raised by different controls on the same page. The ASPxPivotGrid persists cell values and texts between postbacks.

• BC769: The PivotGridControl.OptionsData.DataFieldUnboundExpressionMode property has been added.

  A new option has been added - PivotGridControl.OptionsData.DataFieldUnboundExpressionMode. This option controls the pivot grid's behavior when calculating Unbound Expression and Condition Expression.
  
  By default, the DataFieldUnboundExpressionMode option is set to DataFieldUnboundExpressionMode.Default. In this instance, the pivot grid behaves like in v9.3. The expressions use the PivotGridField.FiledName property to refer to data fields. The Unbound Expression of data fields is calculated based on a data source records.
  
  If the DataFieldUnboundExpressionMode option is set to DataFieldUnboundExpressionMode.UseSummaryValues, the behavior implemented in v10.1.4 is used. In this instance, the expressions identify data fields by their PivotGridField.ExpressionFieldName properties whose values are automatically generated by the pivot grid. Unbound expressions of data fields are calculated based on summary values.

XtraCharts Suite

• BC735: The BarDistance, BarDistanceFixed and EqualBarWidth properties throw an exception when trying to set them for a side-by-side series view, unless a series is added to the chart's collection.

  Now, the BarDistance, BarDistanceFixed and EqualBarWidth properties throw an ArgumentException when trying to set them for the SideBySideBarSeriesView, SideBySideBar3DSeriesView, SideBySideGanttSeriesView, SideBySideRangeBarSeriesView, SideBySideStackedBarSeriesView, SideBySideStackedBar3DSeriesView, SideBySideFullStackedBarSeriesView and SideBySideFullStackedBar3DSeriesView, unless a series is added to the chart's collection.

XtraEditors Library

• BC744: Values of a RadioGroup's items must be unique.

  Values of items in a RadioGroup control must be unique. Otherwise, the items will not be correctly selected.

XtraGrid Suite

• BC730: The IListServer interface implementation has been changed.

  The GetAllFilteredAndSortedRows() method has been added.

XtraPivotGrid Suite

• BC742: The format style condition should have the Field property for a cell format style condition expression applied to certain data field cells.

  If the format style condition does not have the Field property, then the cell format style condition expression will be applied to all cells in the data area.
  
  For an example see How to conditionally format the style of pivot grid cells.

XtraReports Suite

• BC740: The XtraReport.BeginInit and XtraReport.EndInit methods are now for internal use only.

  Use the XtraReport.BeginUpdate and XtraReport.EndUpdate methods instead.