Essential Studio for Xamarin.iOS Release Notes

v15.4.0.17
November 10,2107

SfChart

Enhancements

  • #I149024 – Now, AutoScrollingDelta feature can be shown from first set of data.

Bug Fixes

  • #I189777 – Memory leakage issue has been fixed in SFChart.

DocIO

Features

  • #179888, #182242 - Added support to continue or restart list number while importing Word document.

Breaking Changes

  • WordDocument.Background.Type property will not return the value NoBackground, if show background in print layout view option is disabled and valid background is defined. In this case make use of new property WordDocument.Settings.DisplayBackgrounds to check whether show background in print layout view option is enabled or disabled.
  • #186150 - IsMaxCross property is set to true and secondary axis is added to the right side of the chart, while adding new secondary chart axis. You can set the IsMaxCross property to false, to add secondary axis on the left side.
  • The types Diagonl_Up, Diagonl_Down, From_Corner and From_Center of OfficeGradientStyle enumeration are now deprecated. The new types DiagonalUp, DiagonalDown, FromCorner and FromCenter are added to replace these deprecated types.
  • The property NumberSufix of WListLevel class is now deprecated. The new property NumberSuffix is added to replace this deprecated property.

Bug Fixes

  • #184513 - Formula fields are updated properly while calling UpdateDocumentFields() method.
  • #183656 - NullReferenceException will no longer thrown while closing a particular Word document.
  • #183819 - NullReferenceException will no longer thrown while setting WMergeField.FieldName property.
  • #184348 - NullReferenceException will no longer thrown while parsing a Word document which contains shapes.
  • #186310 - Paragraph is preserved properly while resaving a particular RTF document as DOC format document.
  • #187463 - KeyNotFoundException will no longer thrown while importing a particular Word document.
  • #184941 - Bulleted list is preserved properly while merging multiple documents.
  • #186150 - Document protection is preserved properly while resaving DOCX document to DOCX.
  • #184955 - The Word document is no longer corrupted while setting the DateTime value as chart data.
  • #188782 - ActualFormatType property will retrieve a proper value for all Word formats document.
  • #188160 - Shape is preserved properly while resaving a particular Word document.
  • #189107 - No longer hangs while parsing a particular Word document.
  • #188296, #188686 - Field results are updated properly while performing Mail merge in a particular Word document.
  • #189378 - ArgumentOutOfRangeException will no longer thrown while deleting a bookmark content from a particular Word document.
  • #183627 - Document background color is preserved properly while resaving a particular Word document.
  • #182050 - Page orientation is preserved properly while resaving a particular Word document.
  • #188048 - Tab preservation issue has been resolved while converting a particular Word document as HTML.
  • #187669 - IndexOutOfRangeException will no longer thrown while converting a particular Word document as HTML.
  • #176634, #179293, #184808, #189056 - Table grid’s column width is preserved properly while converting a particular HTML file to Word document.
  • #190219 - NotSupportedException will no longer thrown while opening a Word document which has an invalid OLE data path.
  • #189859 - Image will be preserved properly while converting a particular Word document as HTML.

PDF

Bug Fixes

  • #186604 - PDF document pages are no longer rotated, while merging a particular PDF document.
  • #186765 - Unexpected token error is no longer occurs, while loading particular document.
  • #185183 - The custom metadata added to PDF document is now displayed in custom window of PDF document properties.
  • #182001 - Form fields are not duplicated when load and save the PDF document.
  • #182438 - Named destinations are preserving properly while merging the particular PDF documents.
  • #183859 - The size of the Code128Barcode is now preserved properly.
  • #185884 - Empty page is not created, when merging particular PDF document.
  • #185722 - PDF document with Adobe flash is now merging properly.
  • #185460 - Attachment collection is not empty, when loading a particular PDF document.
  • #185098 - Exception no longer occurs when merging particular PDF document.
  • #184712 - The document keywords are not duplicated when using commas along with keyword.
  • #184488 - Null reference exception no longer occurs when signing existing PDF document.
  • #183595 - ArgumentOutOfRange exception is no longer occurs when importing pages from a particular PDF document.
  • #182417 - Annotation are now removing properly from PdfLoadedPage.
  • #188040 - Preservation issues will no longer occurs while drawing JPEG images.
  • #187013 - PDF layers count is now retrieving properly while loading the existing PDF document.
  • #175611 – Annotation appearance will be preserved properly in Foxit and Bluebeam PDF viewers.
  • #187909 - Exception no longer occur while loading particular PDF document.
  • #189070 - Null reference exception is no longer thrown while accessing cell padding property from PdfGridCellStyle.
  • #188406 - PDF document is no longer corrupted while drawing specific JPEG image into PDF.
  • Child grid cell padding preservation issue is no longer occur in PdfGrid.
  • Annotation transparency is preserving properly when set opacity value as zero.
  • PdfFormFields are now preserving properly while creating in PDF document.
  • Bookmarks are now created properly for particular document.
  • Metadata property is now updating properly when changing document information in PDF document.
  • TextMarkupColor is now preserving properly in PdfFreeTextAnnotation when loading the particular PDF document.
  • The text in the PdfGrid is now aligning properly within the provided space.
  • Signature fields are not duplicating when loading and saving the signed PDF.
  • Form fields are not empty when loading and saving the PDF document.
  • PdfPopupAnnotation is preserving properly after flattening.

Features

  • #151225,183708,124147,130391,131581 – Added support for creating secure PDF documents.
  • #153512,168944,179551,181064,181209,130391,131568 – Added support for drawing PNG images in PDF document.
  • #185022 - Added the support to change the tab order of the form fields.

Presentation

Breaking Changes

  • IsMaxCross property is set to true and secondary axis is added to the right side of the chart, while adding new secondary chart axis. You can set the IsMaxCross property to false, to add secondary axis on the left side.
  • The types Diagonl_Up, Diagonl_Down, From_Corner and From_Center of OfficeGradientStyle enumeration are now deprecated. The new types DiagonalUp, DiagonalDown, FromCorner and FromCenter are added to replace these deprecated types.

Bug Fixes

  • #187206 - Data labels in the bubble chart is now added as expected while creating a chart in PowerPoint presentation.
  • #186544- Null reference exception is no longer thrown while creating a PowerPoint slide with SmartArt diagram.
  • #184264 - The PowerPoint presentation is no longer corrupted while setting the DateTime value as chart data.
  • #186100 - Guides are now preserved properly while creating a PowerPoint slide from an existing layout slide.
  • #186105 - Shape properties are now preserved properly while creating a PowerPoint slide from an existing layout slide.
  • #184967 - Argument out of range exception will not be thrown while cloning a PowerPoint slide with pie chart.
  • #182963 - FontSize property of Font class will now return the correct value.
  • #185237 - The shape name will be preserved like Microsoft PowerPoint, while creating new slide from an existing layout slide.
  • #185236 - The shapes in the footer will be preserved properly while creating new slide from an existing layout slide.
  • #188996 - Null reference exception will be no longer thrown while changing the slide background from SolidFill to PictureFill.
  • #188405 - Object disposed exception will be no longer thrown while saving the cloned PowerPoint presentations.
  • #188525 - Percentage symbols in the chart primary axis are now preserved properly while creating chart in PowerPoint slides.
  • #188081 - Now charts can be created using data from any worksheet of excel file in PowerPoint slides.
  • #188977 - Font color is now preserved properly in PowerPoint slides while retrieving it from the master slide.
  • #187656 - The font name and size are now preserved properly in PowerPoint slides while retrieving those from the master slide.

SfAutoComplete

Breaking Changes

  • SFAutoCompleteDelegate class has been removed along with the Delegate API of the control. Instead of this Delegate, ValueChanged event has been implemented.
  • SFAutoCompleteDelegate class has been removed along with the Delegate API of the control. Instead of this Delegate, FocusChanged event has been implemented.
  • SFAutoCompleteDelegate class has been removed along with the Delegate API of the control. Instead of this Delegate, SelectionChanged event has been implemented.
  • SfAutoComplete UI has been changed. The AutoComplete Search box has been changed to rounded-edge corners and space has been left between SearchBox and DropDownBox.

SfCircularGauge

Breaking Changes

  • Now, load time animation is working properly.

SfDataGrid

Bug fixes

  • #187525, 187527 - While editing is in progress, reloading the SfDataGrid.Columns collection on orientation change, results in application crash has been fixed.
  • #187065 – Exception when calling SfDataGrid.GridColumnSizer.Refresh method programmatically has been fixed.
  • #188577,190181 - Exception thrown, when all the columns are cleared at the runtime has been fixed.

Enhancements

  • Support provided to export data grid to a specific page or specific position in the PDF document.
  • #189412 - Support to customize the editing of GridSwitchColumn based on AllowEditing property has been provided.

SfDateTimeRangeNavigator

Improvements

  • #190410 – Now, it is possible to change the culture of SfDateTimeRangeNavigator dynamically by using Locale property.

SfDiagram Preview

The diagram control can be used to create different types of diagrams such as flow charts, use case diagrams, workflow process diagrams, and more. Also, this control allows you to build applications for creating or editing diagrams interactively.

Features

  • Nodes, connectors, ports: Elements used to compose a diagram.
  • Layouts: Arrange nodes in a tree-like structure based on the relationship between them.
  • Undo/redo: Reverse or re-apply recent changes.
  • Stencil: Holds a list of symbols that is displayed over a diagram.
  • Serialization: Save the current state of the diagram, and load it back when needed.
  • Interaction: Selection, zooming, and panning.

SfNumericUpDown

Breaking Changes

  • Type of Value API has been changed from double to object
  • SFNumericUpDownDelegate class has been removed along with the Delegate API of the control. Instead of this Delegate, ValueChanged event has been implemented.
  • SFNumericUpDownDelegate class has been removed along with the Delegate API of the control. Instead of this Delegate, FocusChanged event has been implemented.
  • SfNumericUpDown UI has been changed. The SfNumericUpDown box has been changed to rounded-edge corners.

SfPdfViewer

Features

  • #188400, #188936 - Provided supports for setting the maximum zoom percentage.
  • #169872 - Provided supports for Text markup annotations (highlight/underline/strikeout).

SfPullToRefresh

Enhancements

  • The pull-to-refresh control supports hosting complex and custom layouts such as list views, data grids, etc, that can be refreshed programmatically or through interaction.

Breaking Changes

  • Use SfPullToRefresh under the namespace Syncfusion.SfPullToRefresh instead of Syncfusion.SfPullToRefresh.iOS namespace.

  • SFPullToRefresh.Delegate property has been marked as obsolete. Instead of writing a custom delegate for pulling and refreshing notifications, you can use the following alternative events.

The below table displays the alternate events provided for the SFPullToRefresh delegate methods.

Methods of SFPullToRefreshDelegate Corresponding events of SfPullToRefresh
SFPullToRefreshDelegate.Pulling(SFPullToRefresh pullToRefresh, float progress) SfPullToRefresh.Pulling
SFPullToRefreshDelegate.Refreshing(SFPullToRefresh pullToRefresh) SfPullToRefresh.Refreshing
SFPullToRefreshDelegate.Refreshed(SFPullToRefresh pullToRefresh) SfPullToRefresh.Refreshed
  • SfPullToRefresh.Refresh method has been marked as obsolete. Hence, to stop the refreshing animation once the data is refreshed, do the following:
    • Instead of using the Refreshing event the namespace Syncfusion.SfPullToRefresh.iOS and calling Refresh method in its call back, use the Refreshing event under the namespace Syncfusion.SfPullToRefresh and simply set the RefreshingEventArgs.Refreshed property as true.
  • The below APIs are marked as obsolete and alternate APIs has been provided. Refer the below table for the obsolete APIs and new APIs.
</tr> </tr>
S.No. APIs marked as obsolete New APIs
1 Syncfusion.SfPullToRefresh.iOS.SFPullToRefresh Syncfusion.SfPullToRefresh.SfPullToRefresh
2 SFPullToRefresh.Progress (type - int) SfPullToRefresh.Progress (type - float)
3 SFPullToRefresh.ProgressBackground SfPullToRefresh.ProgressBackgroundColor
4 SFPullToRefresh.ProgressRadius (type - nfloat) SfPullToRefresh.RefreshContentRadius (type - int)
5 SFPullToRefresh.ProgressStrokeWidth (type - nfloat) SfPullToRefresh.ProgressStrokeWidth (type - double)
6 SFPullToRefresh.PullingThreshold (type - nfloat) SfPullToRefresh.PullingThreshold (type - int)
7 SFPullToRefresh.RefreshContentHeight (type - nfloat) SfPullToRefresh.RefreshContentRadius (type - int)
8 SFPullToRefresh.RefreshContentWidth (type - nfloat) SfPullToRefresh.RefreshContentRadius (type - int)
9 SFPullToRefresh.TransitionMode (type - SFPullTransitionMode) SFPullToRefresh.TransitionType (type - TransitionType)
10 Syncfusion.SfPullToRefresh.iOS.SFPullTransitionMode (enum) Syncfusion.SfPullToRefresh.TransitionType (enum)
  • The below classes, properties and delegates in the namespace Syncfusion.SfPullToRefresh.iOS are marked as obsolete and will not work from this version.
    • SFPullToRefresh.WeakDelegate
    • SFPullToRefresh.SFPullToRefreshAppearance
    • SFPullToRefresh.Appearance
    • SFPullToRefresh.ClassHandle
    • SFPullToRefreshDelegate_Extensions
    • SFPullToRefreshDelegateWrapper
    • SFPullToRefreshDelegate

SfRangeSlider

Breaking Changes

  • SfRangeSlider UI has been changed. The thickness of the slider can be adjusted by the property TrackHeights.

SfSchedule

Bug Fixes

  • #189396 - Now, Schedule recurrence appointment will be get properly in MonthInlineAppointmentLoaded event.
  • #189587 - Now, Schedule TimeZone(CET) works properly.

Features

  • Support for loading custom font to customize schedule labels has been provided.
  • Programmatic date selection and selected date support has been provided.
  • Provided support to customize the number of appointment indicators displayed in month cell.
  • Provided support to scroll to particular time in day, week and work week views.

Breaking Changes

  • The below API are marked as obsolete and alternate APIs has been provided. Refer the below table for the obsolete API and new APIs.
API marked as Obsolete New APIs
CellTappedEventArgs.SelectedAppointment CellTappedEventArgs.ScheduleAppointment CellTappedEventArgs.ScheduleAppointments

XlsIO

Features

  • #156296, #F125729, #185873, #F57065 - Different odd and even page headers/footers, different first page headers/footers for worksheet and chart sheets are now supported in XlsIO.

Breaking Changes

  • #185530, #185561 - Exposed an API Name to get OLE object name in IOleObject class.
  • The properties EvenPage and FirstPage of type IPage are added in IPageSetup class.
  • The properties LeftHeader, CenterHeader, RightHeader , LeftHeaderImage, CenterHeaderImage, RightHeaderImage are added in IPage class to set text and images in the Even and First page headers/footers.

Bug fixes

  • #182915 - Issue with borders being cleared while merging cells is fixed.
  • #183016 - Issue with cell text casing while setting number format is fixed.
  • #183332 - Issue with conditional format is not preserved which has formula as another worksheet range, is fixed.
  • #183361 - Marker color gets changed on resave is fixed.
  • #183369 - Exception is no longer thrown on assigning the scatter chart category axis properties.
  • #183445 - Exception is no longer thrown while inserting rows in XLS format file.
  • #183738 - Performance issue while opening Excel file with multiple charts is fixed.
  • #183799 - Issue while setting print title rows for binary files is fixed.
  • #183807 - CopyTo() method is not working properly after applying AutoFilters is fixed.
  • #184328 - Exception is no longer thrown while applying data validation through ListOfValues property.
  • #184407 - Index out of range exception is thrown while setting RTF text is resolved.
  • #184407 - Key not found exception is thrown while setting RTF text is resolved.
  • #184540 - Binary Excel file gets corrupted while copying range with conditional formats is fixed.
  • #184569 - Cell value with comma character is changed while saving in CSV format is fixed.
  • #184894 - Exception is no longer thrown while adding IconSet multiple times.
  • #185139 - Argument exception is no longer thrown while copying worksheet with EMF images.
  • #185527 - Application hanging issue while opening the Excel file with table is resolved.
  • #184160 - Issue with incorrect margin values on resave is fixed.
  • #183807, #187025 - CopyTo() method is working properly when AutoFilters are applied.
  • #187751 - External exception is no longer thrown while performing text AutoFit in a cell.
  • #186234 - Custom RGB tab color is no longer changed while resaving the Excel file in XlsIO.
  • #187234 - Issue with improper row height is resolved for the given Excel document.
  • #184407 - Exception is no longer thrown while setting RTF text.
  • #185577, #186951 - Rich-text is now properly set for complex RTF string.
  • #186451 - Date filter is now working proper in pivot table.
  • #186446 - UnKnownName exception is no longer thrown while opening CSV files.
  • #185221 - Exception is no longer thrown while opening Excel file with external workbook range in data validation formula.
  • #187026 - Exception is no longer thrown while resaving XLS file with table.
  • #187723 - Overflow exception is no longer thrown while accessing DisplayText for large numbers.
  • #185270 - Key not found exception is no longer thrown while copying range to another workbook multiple times.
  • #187025 - Text filter is now proper in XLSX document.
  • #187181, #187315 - Exception is no longer thrown while invoking IRange.BorderNone.
  • #185921 - File encoding is now correct while parsing zip file with Latin characters.
  • #186738, #187783 - DisplayText returns number value for cell reference formula in Portugal culture.
  • #188856 - Issue with incorrect formula values when formulas contain unknown prefix is fixed.
  • #189191 - InvalidOperationException is thrown while saving Excel document with comments is fixed.
  • #189077 - Issue with InvertIfNegative in chart series data points is fixed.
  • #188263 - Issue with AutoFilterRange when AutoFilter collection is empty, is fixed.
  • #188856 - ReferToRange property now returns proper value for discontinued range.
  • #188787 - File is no longer corrupted while resaving Excel document with XML maps.
  • #188854, #190448 - Application hanging issue while opening Excel document with table AutoFilters is fixed.
  • #188687 - Exception is no longer thrown while adding worksheets after deleting named ranges.
  • #188620, #189263, #190029, #190818, #190866 - Formulas with external workbook reference gives incorrect formula string value is fixed.
  • #155547 - XlsIO memory consumption in row storage class has been reduced.
  • Sorting (descending order) is not working properly when filtering a column is fixed.
  • Issue with copy and paste of formatted cells is fixed.
  • Issue with IsBestFit property while accessing the SetColumnWithPixels method is fixed.
  • Stack overflow exception is no longer thrown while accessing RefersToRange property.
  • Argument exception is no longer thrown while copying one range to another range with styles.
  • Argument exception is no longer thrown when sorting filtered numbers in descending order.
  • The old and new cell values are validated on copy/paste through ValueChanged event.
  • AutoFit is now proper when text in the input file contains line feed and wrap text is set to false.
  • Performance issue in filtering when sheet has comments is fixed.
  • Exception is no longer thrown when coping the defined names between different workbooks.
  • Exception is no longer throw when cloning shape during AddCopy() method.
  • Exception is no longer thrown while accessing table range using formula token.
  • Calculated column formula is not updated during AddCopy() is fixed.
  • Null reference exception is no longer thrown while serializing conditional formats during AddCopy().
  • Issue with ColorRGB in Borders is fixed.
  • Exception is no longer thrown while parsing category labels with external range.
  • Exception is no longer thrown while updating sheet names in Worksheet.AddCopy().
  • Exception is no longer thrown while opening file with PieChart.
  • Exception is no longer thrown while copying conditional formats to another workbook.
  • The old and new cell values are validated on copy and paste operation through ValueChanged event.
  • Format exception due to pivot table data type is fixed.
  • XlsIO returns correct date for the number formats in German culture.
  • Exception is no longer thrown while opening an Excel document with stacked marker chart.
  • CellStyle.Font.RGBColor of a range now returns proper value.
  • DisplayText issue for number formats with ‘GMT’ is fixed.
  • Clearing contents in a merged cell doesn’t remove cell formatting.
  • Issue with incorrect display text for FormulaArrays is fixed.
  • ArgumentOutOfRangeException is no longer thrown while resaving Excel documents with duplicate cell style name.
  • Issue with hidden rows not being copied while using CopyTo() is fixed.
  • Formulas with improper sheet references are now proper on resave.
  • Image rotation will be preserved properly in Excel documents.
  • Issue with incorrect DisplayText value when a cell contains particular IF formula is fixed.
  • Exception is no longer thrown while opening a file with chart sheet.
  • Issue with calculated column formula on resave is fixed.
  • Exception is no longer thrown while cloning a workbook containing table formula using AddCopy().