2024 Releases
This article lists the breaking changes introduced with the Telerik UI for WPF releases in 2024. For the complete list of changes in the UI components, see the product release history.
In 2024 there are breaking changes only in the Q2 and Q4 releases.
Currently, this section of the documentation contains only the latest release notes (starting from 2024). For older changes, check the Breaking Changes and Backward Compatibility help articles of the individual Telerik controls.
2024 Q4 (2024.4.1213)
PersistenceFramework
- The
PersistenceManager
now requires to provide a list of allowed types. If the list isnull
or if a type that is deserialized is not presented in the list, aNotSupportedException
is thrown. TheIsolatedStorageProvider
is also affected as it uses thePersistenceManager
. Read more about this in the Allowed Types article.
2024 Q2
Common Changes
Removed the .NET Core 3.1 distribution of the Telerik dlls.
Removed the .NET Framework distribution of the Telerik dlls. It was replaced with .NET Framework 4.6.2 dlls.
Removed the
Telerik.Windows.Controls.Automation.Peers.RadRangeBaseAutomationPeer
class. Use theTelerik.Windows.Automation.Peers.RadRangeBaseAutomationPeer
class instead.
Docking
Removed the
ElementSaving
andElementCleaning
events ofRadDocking
. Use theElementLayoutSaving
andElementLayoutCleaning
events instead.Removed the
Telerik.Windows.Controls.PaneHeaderAutomationPeer
class. Use theTelerik.Windows.Automation.Peers.PaneHeaderAutomationPeer
class insteand.Removed the
PreviewResizeStart
event ofRadGridResizer
as was not used.Removed one of the
PreviewShowCompassEventArgs
constructors.Removed the
DraggedSplitContainer
property ofPreviewShowCompassEventArgs
. Use theDraggedElement
property instead.
DateTimePicker
Changed the name of the
RadDateTimePicker
'sBlackoutDatesDatesProperty
dependency property toBlackoutDatesProperty
because of a typo.Changed the name of the
RadDateTimePicker
'sIsDownOpenProperty
dependency property toIsDropDownOpenProperty
because of a typo.
DragDropManager
- Removed the
DragDropManager.TouchDragTrigger
attached property and theTouchDragTrigger
enumeration. Use theTouchManager.DragStartTrigger
attached property and theTouchDragStartTrigger
enumeration instead.
Expander
- Removed the
Telerik.Windows.Controls.RadExpanderAutomationPeer
class. UseTelerik.Windows.Automation.Peers.RadExpanderAutomationPeer
instead.
GridView
Removed the
CurrentCellChanged
event ofRadGridView
. Use theCurrentCellInfoChanged
event instead.Removed the
ExportFormat.Xlsx
andExportFormat.Pdf
values from theExportFormat
enumeration. Use the ExportToXlsx and ExportToPdf methods instead.
ListBox
- Removed the
OnIsReadOnlyChanged
protected method ofRadListBox
, because it doesn't do anything.
ProgressBar
- Removed the
Telerik.Windows.Controls.RadProgressBarAutomationPeer
class. UseTelerik.Windows.Automation.Peers.RadProgressBarAutomationPeer
instead.
RichTextBox
- Removed the
HandleDocumentCaretPositionChanging
andHandleDocumentCaretPositionChanged
methods from theKeyboardSelectionHandler
class. Use the ExpandTopRight and ExpandDownLeft methods instead.
TouchManager
- Removed the
TouchManager.IsTouchHitTestVisible
attached property. Use theTouchManager.TouchMode
property instead.
2024 Q4
Common Changes
Removed the .NET 7 distribution of the Telerik dlls.
Removed .NET Core Convert Wizard from the Telerik Visual Studio Extensions.
Barcode
- Removed the old barcode engine. Use the
RadBarcode
control instead. Read more in the following article.
Diagram
Removed the
DiagramCommands.Print
command. Use theDiagramExtensionCommands.Print
command instead.Removed the
Services
protected property of theRadDiagramItem
class. Use theServiceLocator
property instead.Removed the single parameter
OnZIndexChanged
protected virtual method overload of theRadDiagramItem
class. Use the other overload (with the two parameters) instead.Removed the
UnionRects
method of theGraphExtensions
class. Use theUtils.Union
static method instead.Removed the
ZoomFactor
property of theDiagramConstants
class. Use theZoomScaleFactor
property instead.Removed the
InflatedRouterMinimumMargin
property of theDiagramConstants
class. Use theRouterInflationValue
property instead.Removed the
RotationHitTestRadius
property of theDiagramConstants
class. Use theRotationHitTestRadius
property of theManipulationAdorner
class instead.Removed the
Create
method of theSerializationInfo
class. Use one of the following methods instead:CreateItemsInfo
,CreateDiagramInfo
orCreateMetadataInfo
.Removed the
IsLocalValueSet
method of theCommonExtensions
class. Use the same method from theDependencyObjectExtensions
class.Removed the
FromLtrd
method of theUtils
class. Use the constructor of the nativeRect
class instead:new Rect(new Point(left, top), new Point(right, bottom))
Removed the
IsPointInRectangle
methods of theUtils
class. Use theContains
method of the nativeRect
class instead:rect.Contains(point)
Removed the
Center
property of theTreeLayoutProcessor
class. Use the non-staticLayoutCenter
property instead.Removed the
ILayer
interface because it was never used.Removed the
FitTo
method of theRadDiagram
class. Use theBringIntoView
method instead.
Docking
Removed the
OnElementSaving
andOnElementCleaning
protected virtual methods ofRadDocking
. Use theOnElementLayoutCleaning
andOnElementLayoutSaving
methods instead.Removed the
GetRootlevelSplitContainer
method of theDockingLogicalTreeHelper
class because of a typo. Use theGetRootLevelSplitContainer
method instead.
GanttView
- Removed the
GetCorrectedSize
andGetCorrectedRect
methods of theLogicalCanvasPanel
class. The methods were a legacy code used only in the Silverlight branch of the source code. These are not used in WPF.
PdfViewer
Removed the
Commands
property ofRadPdfViewer
. UseCommandDescriptors
property instead.Hid the
FixedDocumentViewerCommands
class. Use theDefaultCommandDescriptors
class instead.Removed the
MoveCaretCommand
class. Use the other caret-related command descriptors in theDefaultCommandDescriptors
class (MoveCaretToPreviousCharacterCommandDescriptor
,MoveCaretToNextCharacterCommandDescriptor
, etc.) instead.Removed the
CaretMovementType
enumeration, because it was no longer needed. Use the caret-related commands of theDefaultCommandDescriptors
class (MoveCaretToPreviousCharacterCommandDescriptor
,MoveCaretToNextCharacterCommandDescriptor
, etc.) instead.Removed the
OnExceptionEventArgs
class. Use theDocumentUnhandledExceptionEventArgs
class instead.
RibbonView
Removed the
DividerDarkBrush
andDividerLightBrush
properties of theButtonGroupPanel
class. Use theBorderBrush
property of theRadButtonGroupItem
instead.Removed the
Position
property of theQuickAccessToolBar
class. Use theQuickAccessToolBarPosition
property ofRadRibbonView
instead.Removed the
ViewportHeight
property of theRadGallery
class. Use theHeight
property instead.Removed the
IsFixedSize
property of theRadRibbonContextualGroup
class.-
Removed the following properties from the
RadRibbonView
class, because are not used by the control:RightTemplate
Align
AllowDragOverTab
AllowDragReorder
-
AllTabsEqualHeight
-
DropDownButtonStyle
-
DropDownDisplayMemberPath
DropDownDisplayMode
DropDownStyle
-
IsDropDownOpen
-
ItemDropDownContentTemplate
-
ItemDropDownContentTemplateSelector
-
LeftTemplate
-
OverflowMode
ScrollMode
TabOrientation
-
TabStripPlacement
-
TopTemplate
BottomTemplate
RichTextBox
Removed the
RadRichTextPageView
class.Removed the
DocumentPosition
's constructor that used callback. Use any of the other constructors instead.Removed the
ForbiddentPropertiesForExportCollection
class.Removed the
Distribute
value from theRadTextAlignment
because it was supported only in Silverlight.Removed the
ListType
enumeration. UseListStyle
instead.Removed the
RadDocumentBindingSource
class.Removed the
DocumentPageItem
class.Removed the
URL
andTarget
properties from theImageInline
class. Use theHyperlinkRangeStart
andHyperlinkRangeEnd
objects to add links instead.Removed the
RegisterFieldUpadtePriority
method from theFieldsUpdateManager
class. Use theRegisterFieldUpdateInfo
method instead.Removed
EMUsToDIP
method of theUnit
class. Use theEmuToDip
method instead.Removed the
Selector
property of theStylePropertyDefinition
class. Use theGetStyleProperty
method of theDocumentElementPropertiesBase
class instead.Removed the
PreserveAnnotationContent
value of theAnnotationMarkerDeleteBehavior
enumeration. Use theAnnotationRangeStart.IsRangeDeletable
andAnnotationRangeStart.IsRangeEditable
properties instead.Removed the
DefaultStyleSettings
property of theDocumentElement
class. Use theStyle
property of theRadDocument
class instead.Removed the
Hyperlink
class. Use theHyperlinkRangeStart
andHyperlinkRangeEnd
classes instead.Removed the
InsertHyperlink
method overloads that take style as a parameter from theIDocumentEditor
interface. Use the other overloads of the method instead.Removed the
DeleteAtDocumentPosition
method ofRadDocument
. Use theDelete
method ofRadDocumentEditor
instead.Removed the
InsertFragment
method ofRadDocument
. Use theInsertFramgment
method ofRadDocumentEditor
instead.Removed the
InsertReadOnlyRange
method ofRadDocument
. Use theInsertReadOnlyRange
method ofRadDocumentEditor
instead.Removed the
DeleteReadOnlyRange
method ofRadDocument
. Use theDeleteReadOnlyRange
method ofRadDocumentEditor
instead.Removed the
DeleteComment
method ofRadDocument
. Use theDeleteComment
method ofRadDocumentEditor
instead.Removed the
InsertComment
method ofRadDocument
. Use theInsertComment
method ofRadDocumentEditor
instead.Removed the
Delete
method ofRadDocument
. Use theDelete
method ofRadDocumentEditor
instead.Removed the
DeleteRange
method ofRadDocument
. Use theDelete
method ofRadDocumentEditor
instead.Removed the
UpdateSelectedSpansStyle
method ofRadDocument
.Removed the
UpdateSelectedParagraphsStyle
method ofRadDocument
.Removed the
UpdateSectionsStyle
method ofRadDocument
.Removed the
UpdateSelectedSectionsStyle
method ofRadDocument
.Removed the
InsertPageBreak
method ofRadDocument
. Use theInsertPageBreak
method ofRadDocumentEditor
instead.Removed the
InsertLineBreak
method ofRadDocument
. Use theInsertLineBreak
method ofRadDocumentEditor
instead.Removed the
InsertInline
method ofRadDocument
. Use theInsertInline
method ofRadDocumentEditor
instead.Removed the
Insert
method ofRadDocument
. Use theInsertInline
method ofRadDocumentEditor
instead.Removed the
InsertField
method ofRadDocument
. Use theInsertField
method ofRadDocumentEditor
instead.Removed the
InsertFootnote
method ofRadDocument
. Use theInsertFootnote
method ofRadDocumentEditor
instead.Removed the
InsertEndnote
method ofRadDocument
. Use theInsertEndnote
method ofRadDocumentEditor
instead.Removed the
InsertPermissionRange
method ofRadDocument
. Use theInsertPermissionRange
method ofRadDocumentEditor
instead.Removed the
InsertBookmark
method ofRadDocument
. Use theInsertBookmark
method ofRadDocumentEditor
instead.Removed the
InsertCustomAnnotationRange
method ofRadDocument
. Use theInsertAnnotationRange
method ofRadDocumentEditor
instead.Removed the
InsertSectionBreak
method ofRadDocument
. Use theInsertSectionBreak
method ofRadDocumentEditor
instead.Removed the
InsertHyperlink
method ofRadDocument
. Use theInsertHyperlink
method ofRadDocumentEditor
instead.Removed the
DeletePermissionRange
method ofRadDocument
. Use theDeletePermissionRange
method ofRadDocumentEditor
instead.Removed the
DeleteCustomAnnotationRange
method ofRadDocument
. Use theDeleteAnnotationRange
method ofRadDocumentEditor
instead.Removed the
DeleteBookmark
method ofRadDocument
. Use theDeleteBookmark
method ofRadDocumentEditor
instead.Removed the
UpdatePermissionRanges
method ofRadDocument
. Use theUpdatePermissionRanges
method ofRadDocumentEditor
instead.Removed the
UpdateField
method ofRadDocument
. Use theUpdateField
method ofRadDocumentEditor
instead.Removed the
UpdateAllFields
method ofRadDocument
. Use theUpdateAllFields
method ofRadDocumentEditor
instead.Removed the
ToggleFieldCodes
method ofRadDocument
. Use theToggleFieldCodes
method ofRadDocumentEditor
instead.Removed the
ChangeFieldDisplayMode
method ofRadDocument
. Use theChangeFieldDisplayMode
method ofRadDocumentEditor
instead.Removed the
ChangeAllFieldsDisplayMode
method ofRadDocument
. Use theChangeAllFieldsDisplayMode
method ofRadDocumentEditor
instead.Removed the
ChangeBibliographicStyle
method ofRadDocument
. Use theChangeBibliographicStyle
method ofRadDocumentEditor
instead.Removed the
PageViewMargin
property ofRadDocument
. Use thePageMargin
property of the correspondingSection
object instead.Removed the
DefaultPageLayoutSettings
property ofRadDocument
. Use theSectionDefaultPageSize
property instead.Removed the parameterized constructor of the
TableLook
class. Use the default constructor instead.Removed the
RemoveCustomDictionary
method overload of theDocumentSpellChecker
class that acceptsICustomWordDictionary
as a parameter. Use the method overload with theCultureInfo
parameter instead.Removed the parameterized overloads of the
BeginUpdate
andEndUpdate
methods of theDocumentSelection
class. Use the parameterless overloads of the methods instead.Removed the
Telerik.Windows.Documents.Proofing.Converters.BooleanToVisibilityConverter
class. UseTelerik.Windows.Controls.BooleanToVisibilityConverter
instead.Removed the
Telerik.Windows.Controls.RichTextBoxUI.RibbonControls.TableStylesGallery.Converters.ColorToBrushConverter
class. UseTelerik.Windows.Controls.ColorToBrushConverter
instead.Removed the
DoubleToVisibilityConverter
class.
Sparklines
Removed
IndicatorsVisiblity
property of theRadLinearSparklineBase
class. Use theIndicatorsVisibilityProperty
instead.Removed the
Telerik.Windows.Controls.Sparklines.RectToRectangleGeometryConveter
class. Use theTelerik.Windows.Controls.Sparklines.RectToRectangleGeometryConverter
class instead.
Spreadsheet
Removed the
DocumentContentChanged
event of theCellEditor
class. Use theTextChanged
event instead.Removed the
OnDocumentContentChanged
protected method ifCellEditor
. Use theOnTextChanged
method instead.
TimeBar
Removed the
IntervalContainerBase
class. Use theTimeBarIntervalContainerBase
class instead.Removed the
IntervalControlBase
class. Use theTimeBarIntervalControlBase
class instead.
Timeline
Removed the
TimelinePeriodContainerBase
class. Use theTimeIntervalContainerBase
class instead.Removed the
TimelinePeriodControlBase
class. Use theTimeIntervalControlBase
class instead.
TreeMap
Removed the
AbsoluteValueBrushColorizer
class. Use theValueBrushColorizer
class instead.Removed the
AbsoluteValueGradientColorizer
class. Use useValueGradientColorizer
class instead.Removed the
RelativeValueBrushColorizer
class. Use theValueBrushColorizer
class instead.Removed the
RelativeValueGradientColorizer
class. Use theValueGradientColorizer
class instead.
WebCam
- Replaced the SharpDX dependencies with SkiaSharp. This was needed because the SharpDX library is no longer maintained since May 2019.