Breaking Changes in Version 8.0.0

Updated over 6 months ago

This article lists the breaking changes introduced with the Telerik UI for .NET MAUI 8.0.0 release version.

DataGrid

• The DataGridStyle, DataGridTextCellStyle, DataGridGroupHeaderStyle, DataGridGroupFooterStyle, DataGridFrozenColumnsSplitterStyle,

DataGridBorderStyle, DataGridLoadOnDemandRowStyle, DataGridColumnHeaderStyle, DataGridColumnFooterStyle, DataGridToggleRowDetailsCellStyle and DataGridStyleSelector classes are removed.

• The GroupHeaderStyle type is changed from DataGridGroupHeaderStyle to Style and targets the new DataGridGroupHeaderAppearance class. For more details on how to style the group headers, review the Group Header Styling article.
• The GroupHeaderStyleSelector type is changed from DataGridStyleSelector to IStyleSelector. For more details on how to apply the GroupHeaderStyleSelector, review the Style Selectors article.
• The GroupFooterStyle type is changed from DataGridGroupFooterStyle to Style and targets the new DataGridGroupFooterAppearance class. For more details on how to apply the GroupFooterStyle, review the Aggregates Styling article.
• The GroupFooterStyleSelector type is changed from DataGridStyleSelector to IStyleSelector.
• The FrozenColumnsSplitterStyle type is changed from DataGridFrozenColumnsSplitterStyle to Style and targets the new DataGridFrozenColumnsSplitterAppearance class.
• The CurrentCellStyle type is changed from DataGridBorderStyle to Style and targets the new DataGridCurrentCellAppearance class. For more details on how to style the current cell, review the Current Cell article.
• The RowBackgroundStyle type is changed from DataGridBorderStyle to Style and targets the new DataGridRowBackgroundAppearance class. For more details on the row styling, review the DataGrid Styling article.
• The AlternateRowBackgroundStyle type is changed from DataGridBorderStyle to Style and targets the new DataGridAlternateRowBackgroundAppearance class. For more details on the row styling, review the DataGrid Styling article.
• The LoadOnDemandRowStyle type is changed from DataGridLoadOnDemandRowStyle to Style and targets the new DataGridLoadOnDemandRowAppearance class.
• The SelectionStyle type is changed from DataGridBorderStyle to Style and targets the new DataGridSelectionAppearance class. For more details on how to style the selected row, review the DataGrid Styling article.
• The MouseHoverStyle type is changed from DataGridBorderStyle to Style and targets the new DataGridMouseHoverAppearance class. For more details on how to apply the MouseHoverStyle, review the DataGrid Styling article.
• The DataGridColumn'HeaderStyle type is changed from DataGridColumnHeaderStyle to Style and targets the new DataGridColumnHeaderAppearance class. For more details on how to style the column header, review the Columns Styling article.
• The DataGridColumn'FooterStyle type is changed from DataGridColumnFooterStyle to Style and targets the new DataGridColumnFooterAppearance class. For more details on how to style the column footer, review the Columns Styling article.
• The DataGridColumn'CellDecorationStyle type is changed from DataGridBorderStyle to Style and targets the new DataGridCellDecorationAppearance class. For more details on how to apply cell decoration, review the Columns Styling article.
• The DataGridColumn'CellDecorationStyleSelector type is changed from DataGridStyleSelector to IStyleSelector.
• The DataGridToggleRowDetailsColumn'CellContentStyle type is changed from DataGridToggleRowDetailsCellStyle to Style and targets the new DataGridToggleRowDetailsCellAppearance class.
• The DataGridToggleRowDetailsColumn'CellContentStyleSelector type is changed from DataGridStyleSelector to IStyleSelector.
• The DataGridTypedColumn'CellContentStyle type is changed from DataGridStyle to Style and targets the new DataGridTextCellAppearance class. For more details on how to style the columns cells, review the Columns Styling article.
• The DataGridTypedColumn'CellContentStyleSelector type is changed from DataGridStyleSelector to IStyleSelector. For more details on how to apply the CellContentStyleSelector, review the Style Selectors article.

AutoComplete

• The RadAutoCompleteEntry automation Id is changed to RadAutoCompleteTextInput.
• TextInputStyle property with target type Telerik.Maui.Controls.RadTextInput control is added. For more details on how to style the TextInput, review the AutoComplete Styling article.
• The ClearButtonStyle target is changed from RadButton to RadTemplatedButton. For more details on how to style the clear button, review the AutoComplete Styling article.

Barcode

The RadBarcode class is migrated from the Telerik.Maui.Controls.Compatibility.Barcode namespace to the Telerik.Maui.Controls namespace.

The following enumerations are migrated from the Telerik.Maui.Controls.Compatibility.Barcode namespace to the Telerik.Maui.Controls.Barcode namespace:

• CheckMSI
• Encodation
• SymbolSize
• EncodingMode
• CodeMode
• ECIMode
• ErrorCorrectionLevel
• FNC1Mode
• SizingMode
• ErrorCorrectionLevel

The following classes are migrated from the Telerik.Maui.Controls.Compatibility.Barcode namespace to the Telerik.Maui.Controls.Barcode namespace:

• Codabar
• Code11
• Code128, Code128A, Code128B, and Code128C
• Code25Interleaved and Code25Standard
• Code39 and Code39Extended
• Code93 and Code93Extended
• CodeMSI
• EAN128, EAN128A, EAN128B, and EAN128C
• EAN13
• EAN8
• IntelligentMail
• Planet
• Postnet
• Symbology1DBase
• UPCA, UPCE, UPCSupplement2, and UPCSupplement5
• DataMatrix
• PDF417
• QRCode
• SwissQRCode
• SymbologyBase

ComboBox

• The RadComboBoxEntry automation Id is changed to RadComboBoxTextInput.
• The DropDownButtonStyle target is changed from RadButton to RadTemplatedButton. For more details on how to style the drop-down button, review the ComboBox Drop Down Styling article.
• The ClearButtonStyle target is changed from RadButton to RadTemplatedButton. For more details on how to style the clear button, review the ComboBox Styling article.

Map

• The Map component is moved to the Telerik.Maui.Controls namespace.
• The ShapefileLayer class is renamed to MapShapefileLayer.
• The GetBestView method type is changed from Telerik.Maui.Controls.Compatibility.ShapefileReader.LocationRect to Telerik.Maui.Controls.ShapefileReader.LocationRect.
• The SetView method type is changed from Telerik.Maui.Controls.Compatibility.ShapefileReader.LocationRect to Telerik.Maui.Controls.ShapefileReader.LocationRect.
• The InteractionMode property type is changed from InteractionMode to MapInteractionMode.
• The SelectionMode property type is changed from SelectionMode to MapSelectionMode.
• The ZoomInCommand and ZoomOutCommand commands type is changed from ZoomInCommand and ZoomOutCommand to MapZoomInCommand and MapZoomOutCommand.

Entry

• The Entry component is now templated control. It has ControlTemplate and visual states. For more details on the provided visual states, review the Entry Visual States article.
• The ClearButtonColor, HoveredClearButtonColor and PressedClearButtonColor properties are removed. Use the ClearButtonStyle (Style with target type RadTemplatedButton) to style the clear button. For more details on how to style the clear button, review the Entry Clear Button Style article.
• The FocusedBorderBrush and FocusedBorderThickness properties are removed. Use the focused visual state to set the BorderBrush and BorderThickness properties. Review the Entry Visual States article.
• The RadEntryEditor automation Id is changed to RadEntryTextInput.

MaskedEntry

• The ClearButtonColor, HoveredClearButtonColor and PressedClearButtonColor properties are removed. Use the ClearButtonStyle (Style with target type RadTemplatedButton) to style the clear button. For more details on how to style the ComboBox drop-down button, review the MaskedEntry Styling article.

NumericInput

• The EntryStyle property is removed. TextInputStyle is added, the TextInputStyle targets the Telerik.Maui.Controls.RadTextInput control. For more details on how to style the NumericInput, review the NumericInput Styling article.
• The NumericInputEntry class is removed, NumericInputTextInput is added.
• The NumericInput now uses RadTemplatedButtons for increase/decrease buttons instead of RadButtons - IncreaseButtonStyle and DecreaseButtonStyle now target the Telerik.Maui.Controls.RadTemplatedButton control.
• The NumericInputButton class is removed. RadTemplateButton is used instead.
• The Telerik.Maui.Controls.NumericInput.ValueChangedEventArgs is removed. The ValueChanged event now uses Telerik.Maui.Controls.ValueChangedEventArgs.
• The NumericEntry automation Id is changed to NumericTextInput.

Path

• The Geometries class in the Telerik.Maui.Controls.Compatibility.Input namespace is deleted. All properties and methods are moved to the RadGeometry class in the Telerik.Maui.Controls.Paths namespace.

The followig clases are moved from the Telerik.Maui.Controls namespace to the Telerik.Maui.Controls.Paths namespace:

• RadPathGeometry
• RadEllipseGeometry
• RadLineGeometry
• RadRectangleGeometry
• GeometryTypeConverter
• RadArcSegment
• RadArcToSegment
• RadConicSegment
• RadCubicSegment
• RadLineSegment
• RadQuadraticSegment
• RadPathSegment
• RadPathFigure

Rating

• The RadShapeRating class is moved from the Telerik.Maui.Controls.Compatibility.Input namespace to the Telerik.Maui.Controls namespace.
• The RadTemplatedRating class is moved from the Telerik.Maui.Controls.Compatibility.Input namespace to the Telerik.Maui.Controls namespace.
• The Geometries class in namespace Telerik.Maui.Controls.Compatibility.Input is deleted. All properties and methods are moved to the RadGeometry class in the Telerik.Maui.Controls.Paths namespace.
• The StringToItemShapeTypeConverter class in namespace Telerik.Maui.Controls.Compatibility.Input is renamed to the RatingStringToItemShapeTypeConverter class and moved to the Telerik.Maui.Controls namespace.