Release History

Telerik UI for .NET MAUI 8.0.0 (2024 Q4)

November 13, 2024

What.New

NEW

• Added support for .NET 9 official.
• Introduced preview theming for Telerik UI for .Net Maui controls, with full support for all input controls, DataGrid, CollectionView, Scheduler, Calendar, TabView, Buttons, Pickers and more.
• Added a new DataPager component that works in collaboration with a DataGrid, and it provides users with a navigation interface for paging through any data collection.
• Added a new GridSplitter component - a component that redistributes space between columns or rows of a Grid control.
• PDF Processing: Introduced support for JavaScript actions.
• PDF Processing: Introduced support for ligatures.
• WordsProcessing: Introduced support for Justify text alignment.

CHANGED

• End of support for .Net 7.
• Obsoleted RadListView. Instead, use RadCollectionView which offers improved performance, enhanced features, and a modernized approach to managing lists of data.
• With the introduction of the Theming mechanism, we have made a number of changes in our AutoComplete, Barcode, ComboBox, DataGrid, Entry, Map, MaskedEntry, NumericInput, Path, and Rating controls. For detailed information on the breaking changes and guidance on necessary actions, please refer to the article Breaking Changes in 8.0 available in our documentation.
• Document Processing Libraries: Remediated CVE-2024-8049 - (CVE-2024-8049).

Accordion

FIXED

• Cannot change the IndicatorColor of the AccordionItemHeader.

AutoComplete

NEW

• Added new property TextInputStyle with target type Telerik.Maui.Controls.RadTextInput. For more details on how to style the TextInput, review the AutoComplete Styling article.
• Added AutoCompleteRemoveTokenCommand class to provide custom RemoveTokenCommand implementation. Exposed RemoveTokenCommand that is executed when the user taps on the clear button of each token.
• Added AutoCompleteClearTextCommand class to provide custom ClearTextCommand implementation. Exposed ClearTextCommand that is executed when the user taps on the AutoComplete's clear button.

CHANGED

• The ClearButtonStyle target type is changed from RadButton to RadTemplatedButton. For more details on how to style the clear button, review the AutoComplete Styling article.
• The RadAutoCompleteEntry automation Id is changed to RadAutoCompleteTextInput.

Barcode

CHANGED

• RadBarcode is moved from Telerik.Maui.Controls.Compatibility.Barcode namespace to Telerik.Maui.Controls namespace. For the full list of changes, review the Barcode section in our Breaking Changes article.

CollectionView

NEW

• Added GroupTapping event that can be used to cancel the tap operation performed on the group.
• Added HorizontalScrollBarVisibility and VerticalScrollBarVisibility properties to RadCollectionView.

ComboBox

NEW

• Added new property TextInputStyle. Defines the style of the inner RadTextInput control used when the ComboBox is editable.
• Added ComboBoxRemoveTokenCommand class to provide custom RemoveTokenCommand implementation. Exposed RemoveTokenCommand that is executed when the user taps on the clear button of each token.

FIXED

• [Android] [iOS] [WinUI] Clear button of token is wrong when DisplayMemberPath is changed.
• [WinUI] The control causes a memory leak when its dropdown has been open.

CHANGED

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

Common

CHANGED

• RadGeometry, RadPathGeometry, RadEllipseGeometry, RadLineGeometry, RadRectangleGeometry, RadArcSegment,RadArcToSegment, RadConicSegment, RadCubicSegment, RadLineSegment, RadQuadraticSegment, RadPathSegment, RadPathFigure, GeometryTypeConverter are moved to Telerik.Maui.Controls.Paths namespace.

DataGrid

FIXED

• [iOS][MacCatalyst] Page with DataGrid does not dispose.
• [WinUI] Frozen columns occasionally do not render their content.
• Group header is hardly noticeable when only DataGridToggleRowDetailsColumn is frozen.

CHANGED

• The DataGridStyle, DataGridTextCellStyle, DataGridGroupHeaderStyle, DataGridGroupFooterStyle, DataGridFrozenColumnsSplitterStyle, DataGridBorderStyle, DataGridLoadOnDemandRowStyle, DataGridColumnHeaderStyle, DataGridColumnFooterStyle, DataGridToggleRowDetailsCellStyle and DataGridStyleSelector classes are removed.
• The GroupHeaderStyle property 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 property type is changed from DataGridStyleSelector to IStyleSelector. For more details on how to apply the GroupHeaderStyleSelector, review the Style Selectors article.
• The GroupFooterStyle property 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 property type is changed from DataGridStyleSelector to IStyleSelector. For more details on how to apply the GroupFooterStyleSelector, review the Style Selectors article.
• The FrozenColumnsSplitterStyle property type is changed from DataGridFrozenColumnsSplitterStyle to Style and targets the new DataGridFrozenColumnsSplitterAppearance class.
• The CurrentCellStyle property 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 property 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 property 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 property type is changed from DataGridLoadOnDemandRowStyle to Style and targets the new DataGridLoadOnDemandRowAppearance class.
• The SelectionStyle property 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 property type is changed from DataGridBorderStyle to Style and targets the new DataGridMouseHoverAppearance class. For more details on how to apply the MouseHoverStyle, review DataGrid Styling article.
• The DataGridColumn.HeaderStyle property 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 property 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 property 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 property type is changed from DataGridStyleSelector to IStyleSelector.
• The DataGridToggleRowDetailsColumn.CellContentStyle property type is changed from DataGridToggleRowDetailsCellStyle to Style and targets the new DataGridToggleRowDetailsCellAppearance class.
• The DataGridToggleRowDetailsColumn.CellContentStyleSelector property type is changed from DataGridStyleSelector to IStyleSelector.
• The DataGridTypedColumn.CellContentStyle property 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 property type is changed from DataGridStyleSelector to IStyleSelector. For more details on how to apply the CellContentStyleSelector, review the Style Selectors article.

DatePicker

NEW

• Added DateOnlyToDateTimeConverter to provide DateOnly support.

Entry

FIXED

• [Android] BorderBrush and BorderThickness apply only for the bottom.

CHANGED

• RadEntry is now templated control. It has control template and visual states. For more details on the provided visual states, review the Entry Visual States article.
• Added ValidationErrorLabelStyle (of type Style with target type Label), ValidationErrorImageStyle (of type Style with target type Image), and ValidationErrorColor (of type Color) properties to style the Error view. For more details review the Validation 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 articles.
• The FocusedBorderBrush and FocusedBorderThickness properties are removed. Use the focused visual state to set the BorderBrush and BorderThickness properties. Review the Entry Visual States articles.
• The RadEntryEditor automation Id is changed to RadEntryTextInput.

Expander

FIXED

• Cannot change the IndicatorColor of the ExpanderHeader.

MaskedEntry

CHANGED

• 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 MaskedEntry clear button, review the MaskedEntry Styling article.

Map

CHANGED

• RadMap is moved from Telerik.Maui.Controls.Compatibility.Map to Telerik.Maui.Controls namespace. For the full list of changes, review the Map section in our Breaking Changes article.

NumericInput

NEW

• Added new property BorderBrush of type Brush. Defines the color of the border of the control.
• Added new property BorderThickness of type Thickness. Defines the thickness of the border of the control.
• Added new property CornerRadius of type CornerRadius. Defines the corner radius of the control.
• Added visual states for readonly, mouseover, focus, etc. and permutations with these states such as ReadonlyMouseOver.

FIXED

• Pressing backspace removes the decimal point with the deleted input.

CHANGED

• The EntryStyle property is removed. TextInputStyle is added, the TextInputStyle targets 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 properties now target Telerik.Maui.Controls.RadTemplatedButton control.
• The NumericInputButton class is removed. RadTemplatedButton is used instead.
• The Telerik.Maui.Controls.NumericInput.ValueChangedEventArgs class is removed. The ValueChanged event now uses Telerik.Maui.Controls.ValueChangedEventArgs.
• The NumericEntry automation Id is changed to NumericTextInput.

Path

CHANGED

• The Geometries class in Telerik.Maui.Controls.Compatibility.Input namespace is deleted. All properties and methods are moved to RadGeometry class in Telerik.Maui.Controls.Paths namespace.
  For the full list of changes, review the Path section in our Breaking Changes article.

PdfProcessing

NEW

• Introduced support for Matte color for Soft-Mask Images (SMasks).
• Introduced support for creating documents using CMYK colors.
• Introduced support for JavaScript actions API.
• SkiaImageFormatProvider: Introduced support for Text, TextMarkup, Line, and Stamp annotations.
• Respect the ExtGState`s current stroking alpha constant (CA & ca) when rendering images.
• Introduced support for ligatures.
• Introduced handling the import of documents with the wrong type of action key.
• Introduced support for Trigger Events API related to JS actions.
• Introduced API for setting Image opacity.
• Introduced support for RTL (Right-To-Left) text.
• Introduced Soft-Mask Dictionaries in ExtGState object.
• Implemented Blend Mode parameter of ExtGState object.
• Introduced support for Trigger Events.
• Justified text is now supported.
• Introduced support for Transparency Group XObjects.

FIXED

• An InvalidOperationException is thrown while parsing the Post table of a specific font file on export.
• Wrong colors are exported in Separation colorspaces with ICCBased containing LabColor due to incorrect calculations in Tint transformation function.
• Win32Exception is thrown during a long-running process importing many documents with images.
• An unexpected trace warning when SVG document does not contain clipping.
• Distorted SVG after exporting.
• SkiaImageFormatProvider: Export to image is blocked when Export method is used instead of ExportAsync.
• A NullReferenceException is thrown when writing image content with the PdfPageStreamWriter.
• ArgumentNullException is thrown when resolving DecodeParms collection in Image XObject.
• Form XObject does not takes graphic state color from its content stream context.
• Document text overlaps and is not possible to read for a specific document.
• Decreased performance when loading thumbnails.
• Wrong color appears when the Separation color space with name is set to None.
• Watermark transparency is not imported correctly.
• The Form object does no inherit the graphics state of the page.
• RTL (right-to-left) text is reversed when inserting it directly to a document.

PdfViewer

FIXED

• Implicit Style for PdfViewerSearchContentView is not applied.

Popup

FIXED

• [MacCatalyst] The popup is displayed on the wrong window in case multiple windows are open and the window the popup is shown from is not currently focused.

Rating

CHANGED

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

RichTextEditor

FIXED

• If the control is empty, it is focused only when tapping on top.

SpreadProcessing

FIXED

• Exporting a workbook with two or more charts with axes produces an invalid document.
• Built-in number formats are not reevaluated after changing the culture.

SpreadStreamProcessing

NEW

• Introduced support for importing files with absolute relationship targets.

FIXED

• Cell iteration is interrupted when it hits a cell containing an error.

TimePicker

NEW

• Added TimeOnlyToTimeSpanConverter to provide TimeOnly support.

WordsProcessing

NEW

• Introduced support for Justify text alignment.

FIXED

• RtfFormatProvider: Heading color is not properly exported.
• An InvalidOperationException is thrown when exporting a document containing table with no cells.
• DocFormatProvider: IndexOutOfRangeException is thrown when importing a specific document with defined section columns.
• ArgumentException is thrown during MailMerge of a document with an inline shape.

ZipLibrary

FIXED

• An invalid content appears after updating an empty password-protected archive.