New to Telerik UI for WPF? Download free 30-day trial

Backward Compatibility

This article lists the breaking changes and how they can be fixed when upgrading from a specific version of the controls to the next one.

What's Different in 2018 R2

Changed

The default value of Telerik.Windows.Documents.Spreadsheet.Model.Printing.SheetPageSetupBase::PaperType has been changed from A4 to Letter.

What to do now

If you need to keep the document with A4 PaperType, you can apply this setting before exporting it:

foreach (Worksheet worksheet in workbook.Worksheets) 
{ 
    worksheet.WorksheetPageSetup.PaperType = PaperTypes.A4; 
} 

What's Different in 2016 R3

Changed

Telerik.Windows.Controls.Spreadsheet.Controls::ProtectionButton is obsolete.

What to do now

The control can be replaced with any other button.

What's Different in 2016 Q1

Changed

Telerik.Windows.Maths.dll is removed and integrated in Telerik.Windows.Documents.Spreadsheet.

Changed

Telerik.Windows.Maths::InterpolationExtensions is now internal.

Changed

Telerik.Windows.Maths::RVector is now internal.

Changed

Telerik.Windows.Documents.Spreadsheet.Expressions.Functions::FunctionBase.Evaluate(RadExpression[] arguments) method is obsolete.

What to do now

Use Telerik.Windows.Documents.Spreadsheet.Expressions.Functions::FunctionBase.Evaluate(FunctionEvaluationContext context) instead.

Changed

Telerik.Windows.Documents.Spreadsheet.Expressions.Functions::FunctionBase.EvaluateOverride(RadExpression[] arguments) is obsolete.

What to do now

Use Telerik.Windows.Documents.Spreadsheet.Expressions.Functions::FunctionBase.EvaluateOverride(FunctionEvaluationContext context) instead.

Changed

Telerik.Windows.Documents.Spreadsheet.Expressions.Functions::FunctionWithArguments.EvaluateOverride(object[] arguments) is obsolete.

What to do now

Use Telerik.Windows.Documents.Spreadsheet.Expressions.Functions::FunctionWithArguments.EvaluateOverride(FunctionEvaluationContext<object> context) instead.

Changed

Telerik.Windows.Documents.Spreadsheet.Expressions.Functions::FunctionWithSameTypeArguments<T>.EvaluateOverride(T[] arguments) instead.

What to do now

Use Telerik.Windows.Documents.Spreadsheet.Expressions.Functions::FunctionWithSameTypeArguments<T>.EvaluateOverride(FunctionEvaluationContext<T> context) instead.

What's Different in 2015 Q2

Changed

Telerik.Windows.Documents.Spreadsheet.Layout.Layers.WorksheetRenderUpdateContext::ViewportPaneTypeToVisibleCellBoxes property is removed.

What to do now

Use Telerik.Windows.Documents.Spreadsheet.Layout.Layers.WorksheetRenderUpdateContext::VisibleCellLayoutBoxes property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.WorksheetUIUpdateContextBase::ViewportPaneTypeToVisibleCellBoxes property is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.WorksheetUIUpdateContextBase::VisibleCellLayoutBoxes property instead.

Changed

Telerik.Windows.Documents.Spreadsheet.Measurement.FontManager is removed.

What to do now

Use Telerik.Windows.Documents.Core.Fonts.SystemFontsManager class instead.

Changed

Telerik.Windows.Documents.Spreadsheet.Model.SpreadsheetNameCollectionScope::Name property is removed.

What to do now

Use the ScopeName property of the Telerik.Windows.Controls.Spreadsheet.Dialogs.SpreadsheetNameView class instead.

Changed

Telerik.Windows.Documents.Spreadsheet.Model.SelectionState::SelectionState(IEnumerable selectedRanges, CellIndex activeCellIndex) constructor is removed.

What to do now

Use Telerik.Windows.Documents.Spreadsheet.Model.SelectionState::SelectionState(IEnumerable selectedRanges, CellIndex activeCellIndex, ViewportPaneType pane) constructor instead.

Changed

Telerik.Windows.Documents.Spreadsheet.Utilities.UnitHelper::EMUsToDIP(int value) is removed.

What to do now

Use EmuToDip(double value) method instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Controls.PrintWhatDropDownItemModel::PrintWhat is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Controls.PrintWhatDropDownItemModel::ExportWhat property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Dialogs.NameManagerDialogViewModel::SpreadsheetNames is removed.

What to do now

Use the Telerik.Windows.Controls.Spreadsheet.Dialogs.NameManagerDialogViewModel::SpreadsheetNameViews property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Dialogs.NameManagerDialogViewModel::SelectedSpreadsheetName is removed.

What to do now

Use the SelectedSpreadsheetNameView property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.IRadSheetEditor::Viewport is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.IRadSheetEditor::SheetViewport property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Layers.UILayer::Container is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Layers.UILayer::ContainerManager property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Layers.UILayer::GetAddedUIElements is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Layers.UILayer::GetAddedUIElements(ViewportPaneType viewportPaneType) instead.

Changed

Telerik.Windows.Controls.Spreadsheet.PrintWhat is removed.

What to do now

Use Telerik.Windows.Documents.Spreadsheet.FormatProviders.ExportWhat enum instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Margins.IRowColumnHeadingMargin::Container is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.Margins.IRowColumnHeadingMargin::ContainerManager property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.BoxBasedUILayer<Т>::GetAssociatedBoxForUIElement(UIElement uiElement) is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.BoxBasedUILayer<Т>::GetAssociatedBoxForUIElement(ViewportPaneType viewportPaneType, UIElement uiElement) instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.BoxBasedUILayer<Т>::GetAssociatedUIElementForBox(T box) is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.BoxBasedUILayer<Т>::GetAssociatedUIElementForBox(ViewportPaneType viewportPaneType, T box) instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.BoxBasedUILayer<Т>::IsUIElementValidOverride(T box, WorksheetUIUpdateContext updateContext) is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.BoxBasedUILayer<Т>::IsUIElementValidOverride(T box, WorksheetUIUpdateContextBase updateContext) instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.BoxBasedUILayer<Т>::GetVisibleBoxes(WorksheetUIUpdateContext updateContext) is removed.

What to do now

Use GetVisibleBoxes(ViewportPaneType viewportPaneType, WorksheetUIUpdateContextBase updateContext) instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.BoxBasedUILayer<Т>::CreateUIElementForBox(T box, WorksheetUIUpdateContext updateContext) is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.BoxBasedUILayer<Т>::CreateUIElementForBox(ViewportPaneType viewportPaneType, T box, WorksheetUIUpdateContextBase updateContext) instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.BoxBasedUILayer<Т>::SetUIElementPropertiesForBox(UIElement uiElement, T box, WorksheetUIUpdateContext updateContext) is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.BoxBasedUILayer<Т>::SetUIElementPropertiesForBox(UIElement uiElement, T box, WorksheetUIUpdateContextBase updateContext) instead.

Changed

Telerik.Windows.Controls.Spreadsheet.RadSheetEditorBase::Viewport is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.RadSheetEditorBase::SheetViewport property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.UIUpdateContext::Viewport is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.UIUpdateContext::SheetViewport property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.UIUpdateContext::Translate(Point point) is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.UIUpdateContext::Translate(Point point, ViewportPaneType viewportPaneType) instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Commands.Descriptors.ActiveCellDependentCommandDescriptor is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Commands.Descriptors.CommandDescriptor class instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Commands.Descriptors.HistoryDependentCommandDescriptor is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Commands.Descriptors.CommandDescriptor class instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Commands.Descriptors.SelectionDependentCommandDescriptor is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Commands.Descriptors.CommandDescriptor class instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Commands.Descriptors.SheetCollectionDependentCommandDescriptor is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Commands.Descriptors.CommandDescriptor class instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.IRadWorksheetEditorPresenter::VisibleCellRange is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.IRadWorksheetEditorPresenter::SheetViewport property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.IRadWorksheetEditorPresenter::Viewport is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.IRadWorksheetEditorPresenter::SheetViewport property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.WorksheetUILayerBase::UpdateUIOverride(WorksheetUIUpdateContext updateContext) is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.Layers.WorksheetUILayerBase::UpdateUIOverride(WorksheetUIUpdateContextBase updateContext) instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.RadWorksheetEditorHistoryState::SelectionState is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.RadWorksheetEditorHistoryState::SheetViewState property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.RadWorksheetEditorPresenterBase::UpdateHorizontalScrollBar(Rect viewport, double smallChange) is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.RadWorksheetEditorPresenterBase::UpdateHorizontalScrollBar(SheetViewport sheetViewport, double smallChange) instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.RadWorksheetEditorPresenterBase::UpdateVerticalScrollBar(Rect viewport, double smallChange) is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.RadWorksheetEditorPresenterBase::UpdateVerticalScrollBar(SheetViewport sheetViewport, double smallChange) instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.RadWorksheetEditorPresenterBase::ViewportChanged is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.RadWorksheetEditorPresenterBase::SheetViewportChanged event instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Worksheets.RadWorksheetEditorPresenterBase::OnViewportChanged is removed.

What to do now

Use Telerik.Windows.Controls.Spreadsheet.Worksheets.RadWorksheetEditorPresenterBase::OnSheetViewportChanged instead.

Changed

Telerik.Windows.Controls.Spreadsheet.Controls.PrintWhatDropDownItemModel::PrintWhat is removed.

What to do now

Use ExportWhat property instead.

Changed

Telerik.Windows.Controls.Spreadsheet.PrintWhatSettings::PrintWhat is removed.

Changed

Telerik.Windows.Controls.Spreadsheet.PrintWhatSettings::PrintWhatSettings is removed.

What to do now

Use PrintWhatSettings(ExportWhat exportWhat, bool ignorePrintArea) constructor instead.

Changed

Telerik.Windows.Controls.IconManager is removed.

What to do now

Use IconResource MarkupExtension instead. You can read more about the markup extension at the common Switching Icons at Runtime article and the one for Spreadsheet.

What's Different in 2015 Q1

Changed

CellEditorBase no longer inherits from Textbox.

Changed

Removed CellEditor's InsertText(string), SetText(string, int), SetText(string) and ClearContent() methods.

What to do now

Use the Text property.

Changed

ICellEditor interface:

  • Changed the TextChanged type from TextChangedEventHandler to EventHandler
  • Changed the SelectionChanged type from RoutedEventHandler to EventHandler
  • Removed the int CaretIndex property

Changed

The DocumentContentChanged event of CellEditor is obsolete.

What to do now

Use the TextChanged event instead.

What's Different in 2014 Q3

Changed

The IsEnabled property of the WorkbookHistory class is changed to be by default false. . It is set to true when the Workbook is assigned to a RadSpreadsheet.

What to do now

If you are modifying a Workbook without showing it in RadSpreadsheet and need to preserve the history, set the IsEnabled property to true.

What's Different in 2014 Q1

Changed

The NameBox class uses a ViewModel.

What to do now

Use the properties of the NameBoxViewModel.

In this article