Essential Studio® for Xamarin.Forms Release Notes

v15.3.0.26
August 7, 2017

SfChart

Bug Fixes

  • #182505, #182976 - The issue with font family in axis title has been fixed.

  • #181609 - Now, the axis labels render the multiple line texts properly.

  • #183740 - Now, the chart tooltip template is rendering properly even in Xamarin.Forms latest pre-release versions.

  • #181662 - The data marker template is rendering properly in PieSeries.

  • #183237 - The RangeAreaSeries will no longer throw NullReferenceException when using trackball.

Improvements

  • #177627 - Now, the DateTimeAxis labels will not shift while panning the chart.

  • #176899 - Exposed a property called ShowTrackballInfo in ChartSeries to control its trackball label visibility.

  • #179613 - Performance for StackingAreaSeries has been improved while scrolling the Chart in ScrollView.

Breaking Changes

  • Due to internal architecture change, now, it is not required to add Syncfusion.SfChart.Android.dll and Syncfusion.SfChart.iOS.dll assemblies to your platform specific projects such as Android and iOS in Xamarin.Forms respectively. Hence, you need to remove these two assemblies from your platform specific projects.
  • Due to internal architecture change, ChartSeries.DataCollectionChanged and ChartSeries.DataPointValueChanged events will no longer be raised for performance reasons and these events will be removed in our upcoming release. Instead, you can use the CollectionChanged event of your data source and PropertyChanged event of your data model respectively.

DocIO

Features

  • #177630 - Added support to insert and preserve SVG element in DOCX to DOCX conversion.
  • #178264 - Added support to apply multiple Paragraph Style in a single Paragraph while creating a Word document using DocIO.
  • #94498, #116546, #135202, #168877, #177412, #179488, #180451, #167448, #174699, #128339, #132232, #147998, #172223 - Added support to create and modify the content control in Word documents and map custom XML parts to content control.

Breaking Changes

  • The property SvgData was added to the IWPicture interface.
  • The property EnableStyleSeparator was added to the IWParagraph interface.
  • An overload method AppendPicture was added to the IWParagraph interface.

Bug Fixes

  • #175961, #179927, #180418 - Image missing issue has been resolved while performing Mail merge.
  • #178271 - Extra page preservation issue has been resolved while loading a particular RTF format document.
  • #176369 - Doughnut chart title value retrieved properly while saving a particular Word document.
  • #177890 - Changing the color of a bar chart series is not applied for negative bar series values.
  • #177890 - No longer hangs while opening a Word document which contains chart.
  • #176984 - Formula field results are preserved properly while bookmark has a special character.
  • #177064 - List number preservation issue has been resolved while saving a particular RTF format document.
  • #177586 - StackOverflowException will be no longer thrown while loading a particular RTF format document.
  • #176708 - KeyNotFoundException will be no longer thrown while loading a particular DOCX format document.
  • #179085 - Merge field values are preserved properly while performing Mail merge for a particular Word document using Execute method.
  • #179006 - Underline and Strikethrough is now preserved properly while appending particular HTML file in a Word document.
  • #177295 - Text retrieved properly from WTextFormField instance for a particular Word document.
  • #177679 - NullReferenceException will be no longer thrown while performing Mail merge using empty data table.
  • #165843, #178727 - List number preservation issue has been resolved while importing a particular Word document.
  • #177295 - !Syntax Error is now resolved for SUM(ABOVE) field, while updating fields in Word document.
  • #176369 - ArgumentOutOfRangeException will be no longer thrown while saving a Word document which contains chart.
  • #171046 - MathML element is now preserved properly in DOCX to DOCX conversion.
  • #177380 - System.TypeInitializationException will be no longer thrown while creating a Word document with chart.
  • #180409 - Field results are preserved properly while performing Mail merge.
  • #180588 - German culture texts are preserved properly while importing and exporting a HTML document.
  • #180115 - List number is preserved properly while loading a RTF document.
  • #181317, #180770 - NullReferenceException will be no longer thrown while resaving a Word document.
  • #181263 - Shape missing issue has been resolved while resaving a Word document.
  • #181811 - Bullet characters are preserved properly while resaving a particular RTF document.
  • #181118 - InvalidOperationException will be no longer thrown while getting bookmark contents.
  • #181409 - Chart series color preserved properly while resaving a Word document which contains chart.
  • #181263 - Shape preservation issue has been resolved while resaving a particular Word document.
  • #182249 - MERGESEQ number is preserved properly while performing Mail merge.
  • #180769 - Target file missing issue has been resolved while resaving a particular Word document.
  • #180769 - Update mode of OLE linked Excel worksheet is preserved properly while resaving a Word document.

NuGet

Features

  • Added NuGet support for SfPicker, SfDataForm and SfRadialMenu controls.

Breaking Changes

Removed Syncfusion.SfChart.Android, Syncfusion.SfChart.iOS assemblies from Syncfusion.Xamarin.SfChart Xamarin.Forms NuGet package.

PDF

Features

  • Added the support for digital signature.
  • Added the tagged PDF support with USDA 508 complaint.

Breaking changes

  • Earlier, the PdfLightTable column width will not work as expected, as a result column widths are equally shared. Now this behavior is fixed, the specified width will be allocated for the columns.
  • The property Appearence is marked as deprecated, please use Appearance property from PdfSignature class instead.

Bug Fixes

  • The PdfGrid header is now preserving properly when enable the AllowHorizontalOverflow.
  • #178247 - Internal stream of PdfLoadedDocument is now closing properly when calling the dispose method.
  • #177646 - Unexpected token exception is no longer thrown while loading particular PDF document.
  • #178830 - ArgumentOutOfRangeException is no longer thrown when accessing PdfDocumentInformation property in the particular PDF document.
  • #182338 - args.Skip will be working fine while PDF Grid row split across two pages.
  • #182896 - PdfLightTable columns will be preserve properly with manual width.
  • #180121 - The Barcode has been rendering properly while giving ISO-8859-2 and ISO-8859-5 characters.
  • #179390 - PdfLightTable header will get draw only once when we set ShowHeader value is true.
  • #182001 - NullReferenceException no longer occurs when accessing the appearance of the signature in PdfLoadedDocument.
  • #178963,#181653,#182856 - Cannot access a closed stream object exception is no longer thrown while loading a PDF document.
  • #179731 - Annotations are now preserving properly while rotating the flattened annotation pages.
  • The PdfTextMarkupAnnotation author property is now preserving properly.
  • Fatal error exception is no longer occurs while loading the particular PDF document.

Presentation

Features

  • #177630 - Added support to insert and modify SVG image in PowerPoint presentation.
  • #177587 - Added support to insert columns to a table in PowerPoint presentation.
  • #176530 - Added support to retrieve the target slide of a hyperlink in PowerPoint presentation.

Breaking Changes

  • #176530 - The property TargetSlide was added to the interface IHyperLink.
  • #177630 - The property SvgData was added to the interface IPicture.
  • #177630 - An overload method for AddPicture was added to the interface IPictures.
  • #177630 - An overload method for AddPicture was added to the interface IShapes.
  • #177587 - The method InsertColumn was added to the interface ITable.
  • #177587 - The property ColumnsCount was added to the interface ITable.

Bug Fixes

  • #178672 - Type initialization exception will not be thrown while creating a PowerPoint presentation with charts.
  • #180902 - Argument out of range exception will not be thrown while cloning a PowerPoint slide with pie chart.
  • #179383 - Hyperlink path for another presentation can be now retrieved while loading a PowerPoint presentation.
  • #182353 - Null reference exception will not be thrown while cloning a PowerPoint slide with table.
  • #181902 - Null reference exception will not be thrown while resaving PowerPoint presentations contains internal XML files in custom naming standards.
  • #180904 - The chart data modified with Presentation library will not get reverted, while trying to edit in Microsoft PowerPoint application.
  • #182963 - The previous column formatting will be now preserved properly while inserting a new column in PowerPoint table.
  • #180902 - Null reference exception will not be thrown while cloning and merging slides having charts after disposing the parent PowerPoint presentation.
  • #178009 - Null reference exception will not be thrown while clearing and adding the slides in the PowerPoint presentation.

SfAutoComplete

Bug Fixes

  • #182955 - Now, SfAutoComplete displays the suggestions without delay when fetching data from online.

Breaking changes

  • Appearance of the Autocomplete changed as like standard of Xamarin platform Entry.

SfBusyIndicator

Bug Fixes

  • #183568 - Now, SfBusyIndicator doesn’t freeze the application while rotating the iOS device.

SfCalendar

Bug Fixes

  • #182492 - Now, Month cell BorderColor will be applied properly when changed through OnMonthCellLoaded event.

  • #182194,#182240,#182894 - Customized month cell header’s height will be updated properly.

SfCarousel

Bug Fixes

  • #183438,#183023 - Issue has been resolved with Android platform to have multiple SfCarousel in single page.
  • #181757 - Now, ScaleOffset affects both height and width properly with same proportion.

Breaking changes

  • DataSource property of SfCarousel has been marked as obsolete, use ItemsSource property to set the collection for carousel.
  • ItemsSource API type has been changed from ObservableCollection<SfCarouselItem> to IEnumerable type. Now you can assign/bind any object to the ItemsSource API of Carousel control.

SfCircularGauge

Bug Fixes

  • #175166 - CircularGauge will not be frozen when multiple gauges added inside ScrollView.
  • #131359,182977 - Ranges can be added or removed dynamically.
  • #183108 - Labels are positioning properly at center even for higher values.
  • #183134 - MajorTicks Offset and MinorTicks Offset will work properly [TickSettings.Offset] (https://help.syncfusion.com/cr/cref_files/xamarin/Syncfusion.SfGauge.XForms~Syncfusion.SfGauge.XForms.TickSettings~Offset.html).
  • #177808,181049 -Now RangePointer.EnableAnimation property will work properly.
  • #180385,181542 -CircularGauge no longer will throw “Underflow in restore - more restores than saves” exception when it’s get deployed in Android version 6.0.1 or higher.
  • #179436 - CircularGauge will not overlap with status bar while adding CircularGauge in ScrollView.
  • #180348,180242,179245,179227 - RangePointer will render without setting RangePointer.Offset value.
  • #179146 - Now,CircularGauge will not overlap over other views while adding CircularGauge in ScrollView.

Breaking Changes

  • Headers,Scales,Pointers and Ranges ValueType has been modified from List to ObservableCollection.

SfDataGrid

Bug fixes

  • #183399 - Application crashed while replace the record which is not visible has been fixed.
  • #182525 - Grid gets blanked when programmatically refresh column sizer after scrolling has been fixed.
  • #181790 - Now, Horizontal scrolling works smoothly when vertical scrolling is not present also.

Breaking Changes

  • Numeric button selection background color default value has been changed from FromRgb(0, 175, 240) to FromHex("#007aff").
  • Navigation button color default value has been changed from FromRgb(0, 175, 240) to FromHex("#f2f2f2").
  • Numeric button selection foreground color default value has been changed from Black to White.

  • Numeric button background color default value has been changed from White to FromHex("#f2f2f2").

  • The below APIs are marked as obsolete and alternate APIs has been provided. Refer the below table for the obsolete APIs and new APIs.
S.No. APIs marked as Obsolete New APIs
1 SfDataGridTheme.GetBordercolor SfDataGridTheme.GetBorderColor
2 SfDataGridTheme.GetCaptionSummaryRowForeGroundColor SfDataGridTheme.GetCaptionSummaryRowForegroundColor
3 SfDataGrid.MaxswipeOffSetProperty SfDataGrid.MaxSwipeOffSetProperty
4 SwipeStartedEventArgs.SwipeOffSet SwipeStartedEventArgs.SwipeOffset
5 SfDataGrid.GridTappedEventsArgs SfDataGrid.GridTappedEventArgs
6 SfDataGrid.GridDoubleTappedEventsArgs SfDataGrid.GridDoubleTappedEventArgs
7 SfDataGrid.GridLongPressedEventsArgs SfDataGrid.GridLongPressedEventArgs
8 SfDataGrid.GridUnboundColumnEventsArgs SfDataGrid.GridUnboundColumnEventArgs
9 AutoGeneratingColumnArgs AutoGeneratingColumnEventArgs
10 SfDataGrid.XForms.Renderers.SfPicker SfDataGrid.XForms.Renderer.GridPicker

SfDateTimeRangeNavigator

Bug Fixes

  • #179590 - Now range will be selected properly based on the selected region.

SfKanban

Bug Fixes

SfLinearGauge

Bug Fixes

  • #183108 - Labels are positioning properly at center for higher values .
  • #183275 - Performance has been improved even if we add multiple linear gauges in a page.
  • #173957 - Now dynamic change of SymbolPointer Thickness LinearPointer.Thickness is working properly.
  • #182522 - LabelFontSize PropertyHeader.TextSizeProperty is working properly.
  • #129473 -LinearGauge Scale labels will render properly if the interval value is given in decimal in Xamarin.Forms platform.

Breaking Changes

  • Headers,Scales,Pointers and Ranges ValueType has been modified from List to ObservableCollection.

SfListView

Features

  • #169120, 169722, 171652, 173477, 127846, 175103, 130034, 130224, 179144, 179579, 130558 - Support for pull-to-refresh has been provided.

Bug Fixes

  • #183177, 183252 - Command binding is now triggered for sticky header and sticky footer items.
  • #180183 - Exception is no longer thrown while switching across tabs of TabbedPage rapidly in Android platform.
  • #179579, 183430 - ScrollToRowIndex method now scrolls to appropriate position properly when items are grouped with auto-fit enabled.

SfMaps

Bug Fixes

  • #183630 - SfMaps will render in Real Devices (IOS).

SfNavigationDrawer

Bug Fixes

  • #182865 - Now, DrawerContent will show properly with Bottom drawer position.
  • #180869,#183246,#182601 - Issue has been resolved with navigation when the NavigationDrawer page loaded after the sleep mode in iOS.

SfNumericTextBox

Bug Fixes

  • #184040 - AllowNull issue has been resolved in Android platform.
  • #183469,#182752 - Keyboard will be dismissed properly with Return Key.
  • #182998 - Debug mode issue has been resolved for Syncfusion.NumericTextBox.XForms.dll assembly.

Features

  • #176137 - Support provided to use Return Key in Numeric Keyboard.
  • #181821 - Support has been provided to selected the text on focus.

SfNumericUpDown

Bug Fixes

  • #130973 - Now, SpinButton alignment issues has resolved in Android.

Features

  • #129726 - Support has been provided to customize the SpinButton.
  • #176724 - Support provided to use Return Key in Numeric Keyboard.

SfPdfViewer

Features

  • #181129 - Support for text selection using PDF viewer in Xamarin.Forms has been provided.
  • #171220, #179789 - Improved the performance when loading large PDF documents in Xamarin.Forms.iOS.
  • #171220, #179789 - SfPdfViewer is implemented to support lower version of iOS, now it works from iOS version 6.0 and higher.

Bug Fixes

  • #179008, #182053 - Exception is no longer thrown when we load the PDF document in SfPdfViewer using TabbedPage in Xamarin.Forms.

Breaking Changes

  • In SearchCompleted event, TextSearchEventArgs is removed, instead please use TextSearchCompletedEventArgs.
  • In SearchInitiated event, TextSearchEventArgs is removed, instead please use TextSearchInitiatedEventArgs.
  • PageNumber property in the PageChangedEventArgs is deprecated, instead please use NewPageNumber property.
  • When invoking SearchText with a specified text, SearchCompleted event would be triggered for every page, but now TextMatchFound event will be triggered for each page instead of SearchCompleted event.

SfPicker Preview

The SfPicker control is a simple Picker that displays list of object and allow user to pick an item among them which comes with built-in modes for Time and Date picking

Key Features

  • Multi Column

  • Header view

  • Footer view with default buttons

  • Template support.

  • Custom View support

  • RTL support.

SfPullToRefresh

Bug fixes

  • #182210 - Application no longer crashes while loading Syncfusion.SfRotator inside SfPullToRefresh.

Breaking changes

  • SfPullToRefresh.PullingThershold is renamed as SfPullToRefresh.PullingThreshold for API consistency.

SfRadialMenu Preview

The new radial menu is useful for displaying a hierarchical menu in a circular layout. Typically used as a context menu, it can expose more menu items in the same space than traditional menus.

Key Features

  • Multi Column.

  • Custom view.

  • Custom Segmentation.

  • Font Icons.

  • Drag on view.

  • Rim rotation.

Note: Currently SfRadialMenu is available only on Xamarin.Forms Android and Xamarin.Forms iOS platforms.

SfRating

Bug Fixes

  • #183066 - Issues has been resolved with EnableAutoSize API.

SfRotator

Bug Fixes

  • #182498 - Now, transparent background color will be applied properly.
  • #181340 - Issues has been resolved to load items through ItemsSource in UWP.

SfSchedule

Bug Fixes

  • #181120 - Now, Time text labels are positioned properly with padding in the inline view (iOS).
  • #177517 - Now, selection style background is working properly when tapping the schedule cell (UWP).
  • #177517 - Now, recursive appointments are rendering properly when adding appointments through CellTapped event.
  • #180916 - Now, appointment indicators rendered properly for both normal and recursive appointments in month view (iOS).
  • #182068 - Now, Schedule will navigate to proper date based on region settings.

Breaking Changes

  • Default appearance of schedule control has been improved.
  • CellStyle argument default value has been changed as null in OnMonthCellLoadedEvent of Schedule (Android).

SfTreemap

Bug Fixes

XlsIO

Features

  • #109496, #79552, #74319, #130146, #180064 - Password support is provided in Compression library.
  • #178228 - Support is provided for adding images from external link in Excel documents.
  • #163244, #F130797 - AutoFit support is provided in XlsIO portable library.
  • Sorting support is provided in AutoFilters.
  • Custom filtering support is provided in text filters.

Breaking changes

  • DataSorter property is added in the interfaces IWorksheet and IAutoFilters.
  • AutoFitRows() and AutoFitColumns() are added in the interface IRange of portable library.
  • EnablePartialTrustCode property is added in the interface IApplication.
  • AddPictureAsLink() is added in the interface IPictures.
  • Picture and SvgData properties are added in the interface IPictureShape.
  • The values Contains, DoesNotContain, BeginsWith, DoesNotBeginWith, EndsWith, DoesNotEndWith are added in ExcelFilterCondition enumeration.

Bug fixes

  • #177888 - Exception is no longer thrown while opening a file with error value in named range.
  • #176158 - Opening an Excel document with picture will no longer get corrupted in Mac OS.
  • #178929 - Issue with wrong combo boxes count in an Excel document is fixed.
  • #178697 - Conditional formatting rules are now applied proper with priority.
  • #178368 - Custom number format ends with whitespace is preserved properly.
  • #176718 - DisplayText now returns number value for cell reference formulas.
  • #179055 - Exception is no longer thrown while saving XLS document to XLSX format with invalid named ranges.
  • #178577 - Exception is no longer thrown while opening an Excel document with empty relation in image hyperlink.
  • #179601 - Setting a pivot table row layout to tabular style and saving the document will no longer throw exception.
  • #179303 - Exception is no longer thrown while setting header text within the limit.
  • #175065 - Saving a workbook multiple times will no longer increase its file size.
  • #177928 - Removing worksheets will reduce the file size properly.
  • #178745 - Issue with changes in table formatting after resaving the document is fixed.
  • #177927 - Removing multiple worksheets and saving the document will no longer throw exception.
  • #177832 - License issue in XlsIO assembly has been resolved.
  • #177210 - Issue with wild card criteria search in Excel document is fixed.
  • #180466 - Exception is no longer thrown while opening chart with value axis title.
  • #181226 - Exception is no longer thrown while opening particular file with shape’s offset value exceeding integer limit.
  • #180940 - Issue with font color when setting font style in conditional formats is fixed.
  • #181016 - Exception is no longer thrown while accessing LineStyle property of a shape in threading.
  • #178198 - Exception thrown on parsing the named range with complete file path is fixed.
  • #180478 - Issue with AutoFit when cell text contains line breaks is fixed.
  • #180329 - XML Exception is no longer thrown while parsing Excel file with chart having empty legend position.
  • #180337 - Line width is changed while changing series color for radar chart is fixed.
  • #180213 - Exception is thrown while parsing MissingItemsLimit property in pivot cache is resolved.
  • #179997 - Exception is no longer thrown while opening a chart with discontinuous filtered ranges.
  • #179874 - Default value is not set in Excel pivot table while applying Pivot filter is fixed.
  • #179874 - File corruption issue while applying pivot filter is resolved.
  • #179732 - File is no longer corrupted when table is created with merged cell ranges.
  • #181584 - Overflow exception while accessing Value property is fixed.
  • #179026 - Text is wrongly updated in shapes after add copying of worksheet is fixed.
  • #177928 - File size is not reduced after removing all worksheets is fixed.
  • #177314 - Security settings is enabled in portable platform for Excel 2003 file formats.
  • #183388 - Memory leak issue due to CalcEngine not disabled on workbook dispose is fixed.
  • #183016 - Issue with text casing while setting number format is fixed.
  • #182853 - Performance issue while resaving Excel document with large number of named ranges is fixed.
  • #182915 - Cell contents are cleared on Unmerge() is fixed.
  • #182153 - Issue with setting incorrect HasFormulaString property is fixed.
  • #182422 - Exception is thrown while applying formula to a row due to wrong name index is fixed.
  • #163659 - An overload is now available to open a file with filename and encoding.
  • #182246, 182247 - Named index is now properly updated while copying external formulas using CopyTo().
  • #182241 - External formulas will now be copied proper when destination workbook has formulas.
  • #181970 - Corruption issue while copying external formula is resolved.
  • #181715 - Conditional format formula is properly updated in binary Excel files.
  • #180478 - AutoFit is properly performed while invoking it multiple times for the range with line breaks.
  • #181802 - Exception is no longer thrown while resaving binary Excel file.
  • #181707 - Wrong file header exception while importing particular XML file is fixed.
  • #180842 - File with table formulas is no longer corrupted while resaving in Spanish culture.
  • #181183, 183446 - Wrong syntax error is thrown while performing layout operation in pivot table is fixed.
  • #181190 - Issue with worksheet FindFirst() for search values having pipe character is fixed.
  • #179749 - RefersToRange is null while named range is referring the table range is resolved.
  • #178735 - GDI exception thrown while opening an Excel document in Azure platform is resolved.
  • #181980 - Out of memory exception is no longer thrown while opening Excel document with wide filter range.
  • #181375 - Issue with font index is incorrectly updated while setting same font index for multiple times is fixed.
  • #182125 - Performance issue with applying styles in large number of cells is fixed.
  • Excel file with pivot table no longer gets corrupted during AddCopy().
  • Corruption issue when resaving Excel file with group shapes is fixed.
  • Cell value with cross sheet reference formula will be updated properly.
  • Sorting a range twice with same index will no longer throw exception.
  • Exception is no longer thrown while copying worksheets with chart.
  • Issue with improper print title values is fixed.