Breaking Changes
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
What to do now
Use Telerik.Windows.Documents.Spreadsheet.Model.SelectionState::SelectionState(IEnumerable
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.