Essential Studio for Xamarin.Forms Release Notes

v16.3.0.21
September 21, 2018
Starting with version 16.2 (2018 Vol 2), you need to include a valid license key (either paid or trial key) within your applications. Please refer to this help topic for more information

Common

Breaking Changes

  • Starting with version 16.3 (2018 Vol 3), we have changed the names of a few NuGet packages to better reflect their functionality on various platforms. The list of packages and their new names can be found in this KB article.

DocIO

Features

  • #205783, #F138587 - Added Rotation property in WPicture class.
  • #209664 - Added the preservation support for signature line element in DOCX to DOCX conversion.
  • #112831, #144687, #166519, #209732 - Added support to update SectionPages field in Word to PDF conversion.
  • #214175 - Added support for complex script characters preservation in Word to PDF conversion.

Bug Fixes

  • #209648 - Tab characters are preserved properly while converting Word document as PDF.
  • #204167, #209881 - InvalidOperationException will be no longer thrown while converting Word document as PDF.
  • #204167, #209881 - IndexOutOfRangeException will be no longer thrown while converting Word document as PDF.
  • #208660, #206994, #204167 - ArgumentOutOfRangeException will be no longer thrown while converting Word document as PDF.
  • #208268 - Paragraph spacing is now preserved properly when replacing content in table cell for Word document.
  • #F138091 - Table header is now preserved properly while converting Word document as PDF.
  • #207657 - Word document will be no longer corrupted when inserting image in Word document.
  • #208020 - paragraph spacing is preserved properly while converting Word document as PDF.
  • #208046 - Multi column is now preserved properly in Word Perfect Office Viewer while resaving Word document as RTF.
  • #207861 - Word document will be no longer corrupted in Microsoft Word 2007 application while resaving Word document.
  • #207772 - Image position is now preserved properly while converting Word document as PDF.
  • #207653 - Text shading is now preserved properly while converting Word document as PDF.
  • #207619, #205309 - Table is now preserved properly while converting Word document as PDF.
  • #204167, #209881 - Performance has been improved while converting Word document as PDF.
  • #204167, #209881 - StackOverflowException will be no longer thrown while converting Word document as PDF.
  • #205919 - Image size is now preserved properly while converting Word document as RTF.
  • #206868 - Bookmark hyperlink is now navigated properly while converting Word document as PDF.
  • #203618 - Word to PDF conversion will no longer hang while converting Word document containing text box with square wrapping style in header.
  • #206703 - Word to PDF conversion will no longer hang while converting Word document containing multiple sections with continuous break.
  • #206993, #203639 - NullReferenceException will be no longer thrown while converting Word document as PDF.
  • #206485 - Table splitting issue has been resolved while converting Word document as PDF.
  • #206496, #205904 - Content control content is now preserved properly while converting Word document as PDF.
  • #206202, #205099, #208898, #213761 - List number is now preserved properly while converting Word document as PDF.
  • #205329, #209408, #203051 - Word document will no longer hang while updating document fields in Word document.
  • #205631, #205309 - Text wrapping issue has been resolved while converting Word document as PDF.
  • #205633 - NullReferenceException will be no longer thrown while parsing Word document.
  • #205309 - Table cell text preservation issue has been resolved while converting Word document as PDF.
  • #205309 - Table position issue has been resolved while converting Word document as PDF.
  • #205250 - InvalidOperationException will be no longer thrown while parsing RTF format document.
  • #205188 - StackOverflowException will be no longer thrown while updating document fields in Word document.
  • #202856 - TOC preservation issue has been resolved while converting Word document as HTML.
  • #204774 - NullReferenceException will be no longer thrown while deleting bookmark content in Word document.
  • #204774 - Bookmark content is now deleted properly in Word document.
  • #204542 - TextBox is now preserved properly while converting Word document as PDF.
  • #204342 - Paragraph spacing is now preserved properly while converting Word document as PDF.
  • #202253 - OutOfMemoryException will be no longer thrown while parsing Word document.
  • #180963, #193566 - Font preservation issue has been resolved while converting Word document as PDF.
  • #208059 - MAX field is now properly skipped from updating error result while updating fields in Word document.
  • #209408 - If field result is now properly updated while updating document fields in Word document.
  • #208463 - Paragraph tags are properly created while converting Word document as PDF with accessibility.
  • #211412, #212690 - OutOfMemoryException will be no longer thrown while performing Find & Replace functionality for Word document.
  • #210863, #211412 - ArgumentOutOfRangeException will be no longer thrown while calling the FindAll() API for Word document.
  • #208450 - Table border is now preserved properly while converting RTF document as PDF.
  • #205945 - Word to PDF conversion will no longer hang while converting DOC format Word document containing shape.
  • #211046 - The nested AutoNum field is now properly skipped while updating its container field.
  • #208117 - Hanging issue has been resolved while updating fields in Word document.
  • #211709 - Style attribute is now preserved properly while converting Word document as HTML.
  • #210867 - List number is now restarted properly on importing contents with ImportOptions as ListRestartNumbering and saving the resultant document as DOC format.
  • #209964 - List style is now preserved properly for the first paragraph inserted to a bookmark using Bookmark Navigator.
  • #204947 - Text wrapping issue has been resolved while converting Word document as PDF.
  • #206374 - Content control content is now preserved properly while converting Word document as PDF.
  • #207193 - The first dot(.) character of a paragraph within a table containing decimal tab stop position is now automatically justified like tab (\t) character while converting Word document as PDF.
  • #208463, #213468 - No more extra white spaces are added between the text while converting Word document as PDF.
  • #207687 - Reduced the generated PDF file size by skipping embedding fonts for non-Unicode text while performing Word to PDF conversion.
  • #211192 - External Workbook relation for chart is now preserved properly while resaving DOCX document.
  • #210694 - System.ArgumentNullException will be no longer thrown while converting Word document as PDF.
  • #209466 - InvalidDataException will be no longer thrown while parsing Word document.
  • #207009 - Text format is now preserved properly while performing Mail merge for Word document.
  • #210694 - DOCVARIABLE field name is now preserved properly while creating a field using AppendField() API.
  • #202856 - Tab and underline is now preserved properly in TOC while converting Word document as HTML.
  • #211746, #212459, #214306, #214979 - NullReferenceException will be no longer thrown while importing HTML using AppendHTML() API of .NET Standard 2.0 assembly.
  • #207687 - Font is now embedded by default only for Unicode text to reduce the file size of generated PDF file while converting Word document as PDF.
  • #211746 - ArgumentException will be no longer thrown while performing Mail merge for multiple groups within a table.
  • #211746 - NullReferenceException will be no longer thrown while performing Mail merge for nested groups with empty commands.
  • #208292 - Word to PDF conversion will no longer hang while converting Word document with absolute positioned table extending to multiple pages.
  • #204167 - RTL text is now indented properly while converting Word document as PDF.
  • #204167 - Absolute positioned RTL table is now preserved properly while converting Word document as PDF.
  • #F138530 - Nested table with absolute position are now preserved properly while converting Word document as PDF.

PDF

Features

  • #113882, #114486, #124312, #124927, #133647, #136283, #163372, #174924, #166856, #199371, #210727 - Support for drawing complex script language text in the PDF document.
  • #203690 - Support for adding Long Term Validation (LTV) with digital signature and timestamp.
  • #209230 - Support for resizing the text box value based on its size.
  • #209578 - Support for retrieving the custom metadata (columns) from PDF annotation.
  • #205794 - Support for adding measurement annotations in the PDF document.
  • #203836 - Support for accessing PDF document hash to digitally sign the PDF document.
  • #212579 - Support for time stamping the existing PDF document.
  • #206510 - Support for getting annotation properties from the appearance content stream.
  • #203836 - Support for changing the signature appearance based on the signature validation.

Bug Fixes

  • #209067 - XML files are now importing properly as form fields.
  • #209067 - Drop-down form fields are now exporting properly as XML files.
  • #209809 - Unable to decrypt document without ID exception will no longer occur when decrypting the PDF documents.
  • #209809 - Catalog is not present exception will no longer occur when loading the PDF documents.
  • #209809, #207003 - Password is incorrect exception will no longer occur when loading the PDF documents.
  • #205727, #199398 - URI value from PdfLoadedUriAnnotation is now retrieving properly from the PDF document.
  • #205636 - “Index out of range exception” will no longer occur when loading the PDF documents.
  • #206504 - Imported document size is not increased if the source document contains hyperlinks.
  • #204160 - Content is now preserving properly when adding large text to a PdfGrid cell in landscape page.
  • #206944 - PDF signature appearance is updating properly when using appearance graphics.
  • #209484 - “Null reference exception” will no longer occur when accessing layer of the PDF document.
  • #204266 - Incorrect layer behavior and syntax issues in Preflight when creating layers in the PDF document are now fixed.
  • #207003 - “Index and length must refer to a location within the string” exception will no longer occur when loading the PDF documents.
  • #206043 - The blank page will no longer be created when rotating the PDF documents.
  • #205034 - Preservation issues will no longer occur when adding layers with overlay to PDF documents.
  • #208125 - “Argument Out Of Range exception” will no longer occur when importing pages from the PDF documents.
  • #206826 - All the form fields are now preserving properly when merging the PDF documents.
  • #206864,209809 - Hanging issues will no longer occur when importing pages form the PDF documents.
  • #208472 - PDF document corruption issue will no longer occur when merging the PDF documents.
  • #209467 - “Object reference not set to an instance of an object” exception will no longer occur when loading the PDF document.
  • #206344 - Text box fields are now preserving properly when flattening the PDF document.
  • #207010,206810 - Null reference exception will no longer occur when appending the PDF documents.
  • #204640 - “Can’t convert to rectangle” exception will no longer occur when flattening the PDF documents.
  • #212192 - AutoFontSize property is now working properly with multiline text box form field.
  • #210068 - Symbols are preserving properly when adding text to the PDF document.
  • #210539 - Throws proper exception when loading the password protected PDF document.
  • #203624 - “Argument out of range exception” will no longer occur when parsing PDF layer from the PDF document.
  • #211947 - Existing PDF document is now loading properly without exception.
  • #209974 - “Null reference exception” will no longer occur when importing pages from the specific PDF document.

Presentation

Features

  • #205041 - Added support to directly access the columns of a PowerPoint table.
  • Added support for creating and editing slide transitions in PowerPoint presentation.

Breaking Changes

  • Setter has been added to Text property of ITextBody interface.
  • The property Style has been added to the IPresentationChart interface.

Bug Fixes

  • #209550 - ObjectReferenceException will no longer be thrown while loading a PowerPoint document created with XMLPowerTools.
  • #211236 - Individual shape bounds within the group shapes are now updated to the properties while loading a PowerPoint document.
  • #205502 - Application will no longer hang while re-saving the PowerPoint presentation.
  • AccessViolationException will no longer be thrown while re-saving a PowerPoint document with same file name.
  • StringFormatException will no longer be thrown while creating animations in Afrikaans culture.

SfAutoComplete

Features

  • The right-to-left (RTL) layout support has been provided.

Bug Fixes

  • #207976: Now, DropDown items scrolling works fine with ItemTemplate.
  • #213700: SelectedItem property is now updated properly while removing items in multi selection mode.

SfBusyIndicator

Features

  • The right-to-left (RTL) layout support has been provided.

SfCalendar

Bug Fixes

  • #213576- SelectedDayTextColor is applied on the today date of SfCalendar when setting the SelectionMode as Multiselection (iOS).
  • #213637- The selected dates will be highlighted when SelectedDates property value is assigned programmatically.
  • #210759- Forward and Backward commands are working properly when adding two or more calendar controls in a single page.
  • #214362, 214660- Memory leak has been reduced when navigating between the month views in SfCalendar.
  • #215033, 139808- Time format will be displayed properly in inline view of SfCalendar (iOS).

Enhancements

  • #210461, 210766- The loading and navigation performance of SfCalendarcontrol have been improved. Now, the loading time is about 30% faster than previous versions (Android and iOS).

Breaking Changes

  • Base classes of MonthViewSettings, YearViewSettings, and MonthLabelSettings classes have been changed from View to BindableObject in SfCalendar.
  • The MonthChanged event will be raised initially in SfCalendar.
  • Default height of the Agenda View is 30 % of the control height.
  • The Calendar parameter is deprecated from CalendarTappedEventArgs, DayCellHoldingEventArgs, InlineToggledEventArgs, SelectionChangedEventArgs, InlineEventArgs, CalendarHeaderEventArgs, ViewModeChangedEventArgs, and MonthChangedEventArgs classes in SfCalendar.
  • The day view header UI has been integrated with SfCalendar UI in month view. So when swiping, month cells view will only be animated based on forward or backward moves (Android and iOS).
  • The following methods are marked as obsolete and alternate methods have been provided.
Dependency service marked as obsolete New methods
DependencyService.Get<ICalendar>().MoveToDate(DateTime); calendar.NavigateTo(DateTime);
DependencyService.Get<ICalendar>().Refresh(); calendar.Refresh();
DependencyService.Get<ICalendar>().CollapseInlineView(DateTime); calendar.CollapseInlineView(DateTime);
DependencyService.Get<ICalendar>().ExpandInlineView(DateTime); calendar.ExpandInlineView(DateTime);
DependencyService.Get<ICalendar>().AddDatesInPast(); calendar.AddDatesInPast();
DependencyService.Get<ICalendarDirection>().Forward(); calendar.Forward();
DependencyService.Get<ICalendarDirection>().Backward(); calendar.Backward();

SfCarousel

Features

  • The right-to- left (RTL) layout support has been provided.

SfChart

Bug fixes

  • #F139447 – The ArgumentOutOfRangeException will no longer be thrown when adding a chart to the horizontal stack layout in iOS.

  • #I193203 - Now the line series can be dragged properly with data marker label in UWP.

  • #F138780 - The issue with memory leak that occurs when removing SfChart from ListView with ListViewCachingStrategy.RetainElement has been fixed.

  • #I204323, I205494 - The DateTimeStripLine will be rendered properly in all the time zones in iOS.

  • #I208835 - The RangeAreaSeries will be rendered properly when giving same high and low values with DateTimeAxis in UWP.

  • #I211896 - Now, the LabelPosition works properly when the IsInversed and OpposedPosition properties are set to true in axis.

  • #I214355 - Now, the FontFamily for the chart labels works properly when configuring from XAML code.

Features

  • #I196854 - Now, the chart control supports histogram series type.

  • #I205947 – The stacked doughnut support has been provided to chart.

Enhancements

  • #I151003, I214094 - The collided axis labels can be wrapped into multiple rows.

  • #I146902, I146877 – The GetDataPoints method has been exposed in CartesianSeries class to get the data points that falls into the given rect area or data range.

  • Now, the dashes can be applied to the polar and radar charts when they are rendered as lines.

  • Now, the color and stroke of plotting area can be customized.

Breaking changes

  • The issue where the OffsetX and OffsetY properties did not consider the device density has been fixed. So, the gap between data point and marker might be longer than expected if you have configured the  OffsetX and OffsetY properties and run them on high density Android devices.

  • The following obsolete APIs have been removed in iOS renderer:

    • SFChartDelegate.DidAxisTrackballLabelsGenerate(SFChart, NSArray)

    • SFChartDelegate.DidTrackballLabelsGenerate(SFChart, NSArray)

    • SFChartTrackballBehavior.DrawTrackballGroupedLabels(NSMutableArray, CGPoint, CGRect)

    • SFChartTrackballBehavior.DidTrackballLabelsGenerate(NSArray)

  • The following obsolete APIs have been removed in Android renderer:

    • ChartSeries.DataSource

    • ChartSeries.AnimationEnabled

    • DataMarkerLabelCreatedEventArgs.P0

    • ChartTrackballBehavior.GetView(ChartSeries p0, ChartDataPoint p1, int p2)

    • ChartExtensionUtils.Get(ObservableCollection, Int32)

    • ChartExtensionUtils.Size(ObservableCollection)

    • ChartExtensionUtils.Set(IList, Int32, T)

    • ChartExtensionUtils.Add(ObservableCollection, Int32, T)

    • ChartExtensionUtils.Remove(IList, Int32)

    • ActualRangeChangedEventArgs.P0

    • LabelCreatedEventArgs.P1

    • TooltipCreatedEventArgs.P0

    • TooltipDismissEventArgs.P0

    • ResetZoomEventArgs.P1

    • ScrollEventArgs.P1

    • SelectionZoomEndEventArgs.P1

    • SelectionZoomDeltaEventArgs.P1

    • SelectionZoomStartEventArgs.P1

    • ZoomEndEventArgs.P1

    • ZoomDeltaEventArgs.P1

    • ZoomStartEventArgs.P1

    • ObservableArrayList class

    • ChartObservableArrayList class

SfCheckBox

Bug fixes

  • #213021: Now, the text will be rendered properly in StackLayout with horizontal orientation in the iOS platform.
  • #213746: Now, the tick will be rendered properly when the background color is set to transparent in the iOS platform.

SfCircularGauge

Bug fixes

  • # 137785, # 213102 - The Value property of pointer is updated properly when dragging the pointer.

  • # 210575 – GradientStops in Range can now be updated dynamically in Xamarin.Forms for iOS and UWP.

  • # 210575 –Now,RangePointer is working properly in Xamarin.Forms for iOS.

  • # 212978 – Now, Header is positioned above the Scales and Pointers in Xamarin.Forms for Android.

  • # 214645 - ArgumentOutOfRangeException will no longer be thrown when navigating page with RangePointer

SfComboBox

Features

  • The right-to-left (RTL) layout support has been provided.

Bug Fixes

  • #139064: Issue with binding SelectedItem property has been fixed.

SfDataForm

Bug Fixes

  • #138801 - The custom keyboard settings is now working in DataFormTextEditor.
  • #207970 - The custom editor layout will be rendered properly while adding the linear layout.
  • #213777 - The InvalidCastException will no longer be thrown when converting the DateTimeOffset data type to DateTime.

SfDataGrid

Bug Fixes

  • #205738: Table summary is not displayed in the view when generating summary for the column using custom cell. This issue is fixed.
  • #212458: Editing for individual column does not work when SfDataGrid.AllowEditing is set as false and GridColumn.AllowEditing for the corresponding column is set as true via binding. This issue is fixed.
  • #213258: Unable to re-select a row when SfDataGrid.FrozenColumnCount is greater than 0 in Xamarin.Forms version 3.1. This issue is fixed.
  • #139519: TalkBack voice in accessibility reads wrong cell value in DataGrid after scrolling is performed. This issue is fixed.
  • #210310: GridSwitchColumn is not toggled when SfNavigationDrawer is opened and closed more than once with SfTabView in UWP platform of Xamarin.Forms version 3.1. This issue is fixed.
  • #139144: Programmatically end editing when edited view is unfocused crashes the application. This issue is fixed.
  • #213211: GridPickerColumn display value not updated after editing, when DisplayMemberPath and ValueMemberPath property are set. This issue is fixed.
  • #202831: Rendering issue when DataGrid height is changed in runtime when loaded inside a Xamarin.Forms.Grid. This issue is fixed.
  • #203337: First entry in view gets auto focused when it is loaded as content of GridTemplateColumn in DataGrid. This issue is fixed.
  • #212303: Exception occurs in PagerScrollViewRenderer when disposing while navigating to next page using async call in the Android platform. This issue is fixed.

Features

  • Support for current cell and CurrentCellManager in SfDataGrid has been provided.
  • Support to navigate between the rows and cells of the SfDataGrid using keyboard in UWP and macOS platform of Xamarin.Forms has been provided.
  • Support for handling the keyboard key combinations for editing, navigation and selection in the grid rows and cells for UWP and macOS Xamarin.Forms has been provided.

Enhancements

  • #138892: Support to export the selected rows in the grid to both PDF and Excel formats has been provided.
  • Support to export group summary rows to PDF and Excel formats has been provided.
  • #134610: Support to collapse keyboard with DONE key in all keyboard types for the Android and iOS platforms of Xamarin.Forms has been provided.
  • #199378: Support for aligning the text in all summary rows (TableSummary, GroupSummary and CaptionSummary) has been provided.
  • #193217, #212456: Support for ValueChanged event to notify cell value changes in GridTextColumn, GridNumericColumn and GridSwitchColumn has been provided.
  • #205559: Support to change the width of the borders for the grid cell and header cell elements has been provided.
  • Support for ScrollingMode, VerticalOverScrollMode and EditorSelectionBehavior in macOS platform of Xamarin.Forms has been provided.
  • Support for scrolling using the horizontal and vertical scroll bars when scroll bars are static or when external mouse is connected in macOS platform of Xamarin.Forms has been provided.

Changes

  • Editing a cell is restricted when the SfDataGrid.SelectionMode is set as None.
  • Editing a cell is restricted when the SfDataGrid.NavigationMode is set as Row.
  • For numeric cell renderer associated to GridNumericColumn, the editor element view’s type is changed from SfNumericTextBox to SfNumericTextBoxExt. Hence existing users who have written custom renderers for GridNumericColumn derived from GridNumericColumnRenderer, please use the type SfNumericTextBoxExt in places of SfNumericTextBox.

SfDateTimeRangeNavigator

Bug fixes

  • #I206049 - The issue with duplicate labels generation in minor scale in the French language has been fixed.

Breaking changes

  • The following obsolete APIs have been removed in Android renderer:

    • RangeChangedEventArgs.P1

    • RangeChangedEventArgs.P0

    • MajorScaleLabelsCreateEventArgs.P0

    • MinorScaleLabelsCreateEventArgs.P0

SfDiagram

Bug Fixes

  • #213352 - Now,Diagram.NodeClicked event raises properly on android.
  • #212364 - SourcePoint and TargetPoint properties of the connector updates properly at runtime.
  • #212364 - SourceNode and TargetNode properties of the connector updates properly when adding connector to node’s port.
  • #212364 - Stencil symbol style can be modified properly now.
  • #211646 - System.ObjectDisposedException is properly handled while disposing SfDiagram instance.
  • #210679 - Annotation index is maintained properly when node/connector contains multiple annotations.
  • #206732 - Diagram layer bounds will update properly when changing its height/width at runtime.

Features

  • Overview panel support has been added to easily navigate across the diagram area.
  • #206274 - Default appearance of the node, connector and stencil symbols can be modified now.
  • #206592 - User handle position can be moved or adjusted from its default position.
  • Hierarchy of automatic tree layout can be changed at runtime interactively by dragging and dropping over the node.
  • RTL support has been provided for diagram control.
  • Space between the nodes can be adjusted during automatic tree layouting.
  • Node can be excluded from automatic tree layouting.
  • #206732 - Now, Zoom factor can be set from 0.01 to infinite.
  • Now, Node can be aligned manually in mind map layout.

SfImageEditor

Bug fixes

  • #206794 - Now, ImageLoaded event will be raised when loading images dynamically and enabling or disabling the editor visibility in UWP.

  • #137162 - Now, ImageLoaded event will be raised properly when the image is loaded from file path in iOS.

  • #139298 - Now, the cropper window will work properly on dragging in iOS.

  • #139372 - Now, System.IO.FileNotFoundException will no longer be thrown when image editor is localized.

Features

  • #194419 - Support has been provided to save the images with custom size.

  • #209326 - Support has been provided to customize the text formats such as bold, italic, and underline.

  • #198209 - Multiline support has been provided for text with alignment option.

  • #198209 - Support has been provided to save the images in different formats such as JPG, PNG, and BMP.

  • #204627 - Rotation support has been provided to text and custom view.

  • #213018 - Support has been provided for getting original image size and actual rendered image size

SfKanban

Bug fixes

  • #205719 – The performance of the kanban control has been improved when custom card template is applied in the iOS platform.
  • #212522 – The ArgumentOutOfRangeException will no longer be thrown from the OnClick method of KanbanItemViewHolder class in the Android platform.

SfLinearGauge

Bug fixes

  • # 137575 – The linear gauge Scale displays its maximum value according to the value specified in the MaximumValue property.

  • # 210575 – Now, BarPointer has rendered properly when applying small value for CornerRadius in Xamarin.Forms for Android.

  • # 210575 – The GradientStops in LinearScale can now be updated dynamically in Xamarin.Forms for iOS and UWP.

  • # 214714 - Now, SymbolPointer will update properly on binding the Value property in Xamarin.Forms for iOS.

  • # 215038 - ObjectDisposedException will no longer be thrown when navigating page with SymbolPointer in Xamarin.Forms for iOS.

SfListView

Bug fixes

  • #212555 - In GridLayout, the items will be layout properly while changing the device orientation in iOS platform.
  • #139260 - The sticky group header is updated properly while navigating between the pages in Android and iOS platforms.
  • #211286 - The HeaderTemplate content is updated properly when changing the font size, using binding.
  • #139103 - The binding errors will not occur for the bindable properties like TapCommand, HoldCommand, LoadMoreCommand, and so on.
  • #213866 - In UWP, the scroll states are updated properly when scrolling a page.
  • #139414 - In UWP, scrolling is working properly when using the mouse wheel.
  • #213932 - In iOS, tapping is working properly for the child view which was loaded inside the SfListView, if it is loading in MasterDetailsPage.
  • #208776 - The load more item height will not be changed when changing the layout manager at runtime.
  • #211736 - The scroll position will not be changed in horizontal orientation when navigating between the pages in MasterDetailsPage.
  • #211286,213167 - In iOS platform, exception will no longer be thrown while scrolling the SfListview when loading with DataTemplateSelector.

Features

  • Provided support for detecting ScrollStates in macOS.

Breaking changes

  • When loading the SfListView inside the Carousel or Tabbed page, swiping is not working. Since the swiping support has been provided based on handling the ManipulationMode of ScrollView, the manipulation is not passed to parent. This framework issue has been logged and their response has to come.
  • SwipeOffSetProperty has been renamed into SwipeOffsetProperty.
  • SfLabel class which is used internally for default view has been replaced by framework’s Label.

SfMaps

Bug fixes

  • #209918 – The GeoCoordinates and the Markers properties can now be updated dynamically.

  • #138729 – The MarkerSelected event will not be invoked twice in Xamarin.Forms for iOS.

  • #138729 – The Markers position will not change when selecting/deselecting the marker.

  • #206627 – The NullReferenceException will no longer be thrown when selecting/deselecting the map shape.

  • #206627 – Now, SelectedShapeStroke and SelectedShapeStrokeThickness properties are working properly.

  • #139269 – The binding to the Marker is working properly in Xamarin.Forms for UWP.

Features

  • #196656 - The ImageryLayer zooming performance has been improved by caching tile images in application cache memory.

  • #200850, #202705 - The sublayer support has been provided to load multiple shape files in maps.

  • Color mapping support have been provided for Bubbles.

  • Image icon type support has been provided for map marker.

  • #F138491 - Support has been provided to trim or hide the overlapping data labels.

  • Legend label customization, icon types support has been provided.

  • Support has been provided to render corresponding shape layer from layers collection by setting BaseMapIndex property.

  • ZoomLevelChanging event has been added for ImageryLayer.

SfMaskedEdit

Bug fixes

  • #211483: Now, the typed text will be shown when the Mask property is not explicitly defined in the Android platform.

SfNumericTextBox

Features

  • #202440, #F138627: The Completed event has been provided like Entry control.

SfNumericUpDown

Bug Fixes

  • #211924, #213655: Now, the ValueChanged event will be raised only once for a value change in the UWP platform.

SfPdfViewer

Features

  • #168837, #177531, #178851, #F130579, #186863, #200533, #186360, #208016, #211024, #212751, #213719 - SfPdfViewer now supports bookmark navigation.
  • #212153 - Exposed events for touch interactions.

Bug Fixes

  • #208896 - System.Resources.MissingManifestResourceException will no longer be thrown when enabling the “Common Language Runtime Exceptions” in exception settings.
  • #207135 - Content of the PDF document is now displayed properly.
  • #209019 - Built-in toolbar will work properly when using the SfPdfViewer control with updated Xamarin.Forms (3.0 and 3.1).
  • #209860 - Existing annotations will not be flattened when loading the document.
  • #206990 - ObjectDisposedException will no longer be thrown when navigating between XAML pages in Xamarin.Forms iOS.
  • #211320 - Pages of PDF document are now aligned properly in SfPdfViewer in Xamarin.Forms.iOS as like Adobe reader
  • #211481, #213972 - PDF document is now fit to width of SfPdfViewer in Xamarin.Forms.UWP
  • #211357 - Application no longer crashes when opening the PDF document with large dimension in Xamarin.Forms.iOS
  • #F139440 - NullReferenceException will not occur anymore when unloading the PDF document.

SfPicker

Features

  • The right-to-left (RTL) layout support has been provided.
  • #203828, #206580: Now, the ItemTemplate support for SfPicker control has been implemented.

Bug fixes

  • #213641: The SelectedIndex property two way binding working properly in iOS.
  • #210493: The SfPicker is working properly when changing the single column to multiple column in iOS.

SfPopupLayout

Bug Fixes

  • #204788, #214331: Popup is not overlay in full screen when height and width is set as Double.NaN. This issue is fixed.
  • #212138: HeightRequest and WidthRequest set to the views in the SfPopupLayout.PopupView.ContentTemplate is not applied to it to increase the size of the popup according to the content loaded inside it. This issue is fixed.
  • #211060: NullReferenceException is thrown in the Android platform of Xamarin.Forms when a custom view is added in SfPopupLayout.PopupView.ContentTemplate of popup layout. This issue is fixed.

Enhancements

  • Support to display a pop-up relatively to a view and to customize its relative position directly from XAML has been provided.

SfProgressBar

Bug fixes

  • #213775 - The progress is updated properly when changing the value before the animation is completed.
  • #212783, #210658 - Now, the progress bar will be displayed with appropriate progress value when initialized in the item template of list view.
  • #211926 - Now, the custom content will be shown properly in circular progress bar indeterminate state

Features

  • #F138129 – Support has been provided to map colors to the progress range in the circular progress bar.

SfPullToRefresh

Bug Fixes

  • #208375: Pulling triggers when handling pull to refresh with multiple scrollable items as the pullable content. This issue is fixed.

SfRadialMenu

Features

  • #209296: The background image support for SfRadialMenu has been implemented.

Bug Fixes

  • #212357: Now implicit styling works for the SfRadialMenuItem.
  • #212367: The SegmentIndex property works properly when set LayoutType as custom in Xamarin.Forms iOS.

SfRadioButton

Bug fixes

  • #213021: Now, the text will be rendered properly in the StackLayout with horizontal orientation in the iOS platform.

SfRangeSlider

Features

  • The right-to-left (RTL) layout support has been provided.
  • #205894: TickColor property to customize the tick color has been provided.
  • #203921, #204071, #205952: FontSize and FontFamily properties to customize the labels have been implemented.
  • #F135490, #203709, #209571, #209952: DragStarted and DragCompleted events have been implemented to notify the thumb drag started and completed actions.

SfRating

Features

  • The right-to-left (RTL) layout support has been provided.

Bug Fixes

  • #138707, #213617, #213962 - Now, SfRating control height is calculated properly in UWP when it is used inside SfListView control.

SfRotator

Features

  • The right-to-left (RTL) layout support has been provided.

Bug Fixes

  • #212527: Thumbnail gets update without any delay when adding more than 20 items in the SfRotator
  • #138874: Selection animation works properly when change the SelectedIndex at runtime in iOS.

SfSchedule

Bug Fixes

  • #212293 - The NullReferenceException will no longer be thrown when removing the appointment after Schedule is launched and disappeared in NavigationPage.
  • #213270 - The RuntimeException will no longer be thrown when setting the font family as Lobster-Regular.ttf#Lobster-Regular (Android).
  • #139188, #212504 - The InvalidOperationException will no longer be thrown when calling the UpdateSchedule method.

Features

  • #195491, #198421, #199836, #203330 - Support to skip or change particular occurrences of a recurring appointment by setting exceptions for that recurring appointment.
  • #208167 - Support to customize the selected date text color in month cell.

Enhancements

  • #205861 - Improved swiping performance of the Schedule.
  • #137599, #139216, #213346 - Support to parse the recurrence rule string to generate a recurrence properties object and to get occurrence date collection of a recurring appointment.
  • #204987 - Improved the TapGesture behavior when using custom view for appointments (Android).

SfSegmentedControl

Features

  • The right-to-left (RTL) layout support has been provided.

Bug Fixes

  • #F138887: Default FontSize value now corrected for all the three platforms.
  • #F138887: Color property are working properly in UWP and Android.

SfTabView

Features

  • The right-to-left (RTL) layout support has been provided.
  • #204017: The image support has been implemented in SfTabItem.

Bug fixes

  • #212895: The SfTabView control will be refreshed when adding or removing the items in UWP.
  • #210674: Swiping is working properly for the SfListView that is used inside SfTabView.

SfTextInputLayout Preview

The new text input layout adds decorative elements like floating label, icons, and assistive labels on top of input views such as SfMaskedEdit, SfNumericTextBox, Entry and Editor controls.

Key features

  • Displays floating label when the input view is focused.

  • Displays error label.

  • Supports filled and outlined container type.

  • Displays leading and trailing icons.

  • Displays help label.

  • Displays maximum character count.

  • Password visibility toggling.

SfTreeView Preview

TreeView is a data-oriented control displays data in a hierarchical structure with expanding and collapsing nodes. It is commonly used to illustrate a folder structure, or nested relationships in an application.

Key features

  • Binding and unbound mode - Support for binding hierarchical data or add unbound tree nodes.
  • Selection - Support for selection with different selection modes and keyboard navigation.
  • Templating - Provides complete UI customization through template and template selectors.
  • Customization - Support to change expander width, indentation, item height.
  • Commands - Provides command for user interactions like tap and hold actions.

XlsIO

Features

  • #173702 - Provided support for hyperlinks in data import.
  • #52130, #56162, #135871, #166296, #178721, #180457, #180462, #197799, #198853 - Provided support to calculate external reference formula.
  • #180349 - Provided support for pivot table field sorting with direction.
  • Provided support for custom qualifier and record delimiter for CSV files.
  • #135243, #117497, #131343 - Provided support for worksheet to HTML conversion from .NETStandard 1.4.
  • #135243, #129497, #206936, #208400 - Provided support for worksheet to image conversion from .NETStandard 1.4.

Breaking changes

  • #207306 - DetectMixedValueType enumeration is added for detecting mixed data typed column values while exporting to DataTable.
  • #203029 – - TypeMismatchOnExport event and ExportEventArgs class are added in IApplication interface to notify users about the mismatch between cell type and property type while Exporting data to CLR Objects.
  • Calculate method is added in IWorksheet class to support worksheet formulas calculation.
  • #180349 - AutoSort method is added in IPivotField class.
  • CsvQualifier and CsvRecordDelimiter properties are added in IApplication interface.
  • RemoveAt() is added in WorksheetNamesCollection class to remove worksheet name at particular index.
  • #135243, #129497, #206936, #208400 - Added ExportImageOptions class with ExportImageFormat enumeration, Scaling mode and default constructor, and ConvertToImage method in IXlsIORenderer class.

Bug fixes

  • #209729 - Null reference exception thrown while adding marker variable with copy style argument is resolved.
  • #209443 - Null reference exception thrown while copying empty worksheet range is resolved.
  • #209443 - Shape is not copied properly to another range while clearing range is fixed.
  • #208554 - Application exception ambiguity conflict between Microsoft Common Object Runtime Library. and Syncfusion.Compression NuGet package is resolved.
  • #207203 – Random exceptions on accessing the RTFText property multiple times is resolved.
  • #208141 - Exception thrown while converting the chart with range collection is resolved.
  • #208122 - Exception thrown while opening a file with empty RTF text is resolved.
  • #207732 - Argument exception thrown while opening a workbook of strict XML type is resolved.
  • #207940 - Null reference exception raised while invoking auto fit columns on cells containing formulas is resolved.
  • #207176, #210642 - Issue with conditional formats on a newly created worksheet is fixed.
  • #207151 - Exception will no longer be thrown while saving the workbook created using AddCopy().
  • #206271 - Corruption issue while resaving the file with query table is resolved.
  • #206070 - Formats are preserved correctly while saving XML file as XLSX.
  • #205858 - Table formula with column name in dimension format can be set properly.
  • #204815 - Exception raised while opening an Excel file having the style count greater than maximum unique styles is fixed.
  • #204483 - XML exception raised while opening a binary file with duplicate schema is resolved.
  • #204511 - FindAll() returns expected value when ExcelFindOptions is not provided.
  • #204932 - Exception raised while setting the Fill property for un-supported chart types on opening Excel file is resolved.
  • #204742 - Data connection parameters tag is now serialized while resaving an Excel file.
  • #204130, #204484 - Exception thrown while parsing hyperlink in merged cells is resolved.
  • #203365 - Conditional formats are properly copied while adding a copy of worksheet using AddCopy().
  • #203557 - File corruption issue while generating worksheet from the data table is resolved.
  • #203396 - File corruption while removing comments with picture from the worksheet is resolved.
  • #202487 - Exception will no longer be raised while parsing invalid reference to the chart series name.
  • #204134 - Incorrect chart name retrieved for the binary file is fixed.
  • #207784 - Exception raised while copying custom functions to a different workbook is resolved.
  • #205835 - Exception raised while cloning the workbook with conditional formats is resolved.
  • Exception will no longer be thrown while applying template marker using the IWorksheet.Workbook property
  • Auto filter issue while setting IconSet conditional formatting with NoIcon is resolved.
  • #211514 - NullReferenceException thrown while opening a file in multi-thread environment is fixed.
  • #210082 - Exception thrown while copying an Excel to another document with the named range and saving is resolved.
  • #210172 - Conditional format formulas applied to the ConditionValue property are now properly updated in advanced conditional formats.
  • #210172 - Image protection in XLS documents will not be removed after resave.
  • #209739 - Exception thrown while parsing workbook with empty styles is resolved.
  • #209443 - Merged cells are now properly copied to another range during CopyTo() method.
  • #138492 - Issue with ListOfValues property in Data Validation is fixed.
  • Number formats are returned properly while parsing.
  • Print area is cleared properly when PrintArea is set to null.
  • Out of Memory exception thrown while parsing a CSV file with large number of rows is fixed.
  • Issue with clearing Rich-Text and its formatting is resolved.
  • #212859 - Conditional formats are applied properly in an Excel file generation using XlsIO.
  • #211941 - Row height value in GetRowHeightInPixels is different than Microsoft Excel for a particular document is fixed.
  • #210905 - Styles are preserved properly while resaving the document in Microsoft Excel.
  • #207242 - ArgumentException raised while parsing duplicate number formats in the workbook is fixed.
  • #212951 - XML exception raised while opening an Excel document with invalid chart properties is resolved.
  • #213480 - Data labels formula is properly updated on changing sheet name.
  • #213242 - Title and border color are properly set for the cloned charts in XlsIO.
  • #212887 - Active cell is set properly after freeze panes.
  • #212629, #212683, #212610, #212926 - Unsupported exception thrown in Compression.Base while parsing an Excel document in XlsIO is resolved.
  • #212077 - Corruption issue due to incorrect named ranges is fixed.
  • #213412 - File corruption while applying the SubTotal function is fixed.
  • Exception will no longer be thrown while creating GroupShape with VML shapes.
  • Issue with row height while parsing XML file is fixed.
  • Exception thrown while opening an Excel document in try catch block is resolved.
  • NullReferenceException will no longer be thrown during AddCopy of binary Excel worksheets with XML Excel worksheets.
  • Incorrect seconds value for DateTime type exported from worksheet to DataTable is fixed.