Essential Studio for Xamarin.Forms Release Notes

v16.4.0.52
February 5, 2019

Common

Breaking Changes

  • Visual Studio 2017 and Visual Studio 2019 Preview 2 installed machine, Syncfusion Xamarin.Forms Controls will not be configured in Visual Studio 2017 toolbox. Refer this documentation to configure the toolbox manually.

  • Visual Studio 2017 and Visual Studio 2019 Preview 2 installed machine, Syncfusion Xamarin.Forms extensions will not be configured in Visual Studio 2017. Refer this documentation to configure the extensions manually.

DocIO

Bug Fixes

  • #221972 - Text is now highlighted properly while converting a Word document to tagged PDF.
  • #223350 - Table cell is now preserved properly while opening an HTML document.
  • #222922 - Image is now preserved properly while converting a Word document to PDF.
  • #222713 - The ArgumentException will no longer be thrown while adding a table.
  • #222608 - Font name is now preserved properly while converting an HTML document to Word document.
  • #222751 - The StackOverFlowException will no longer be thrown while converting a Word document to PDF.
  • #222670 - Inline content control text is now preserved properly while converting a Word document to PDF.
  • #222320 - Hyperlink is now preserved properly in inline content control while converting a Word document to PDF.
  • #222345 - The ArgumentOutOfRangeException will no longer be thrown while updating TOC in RTF format document.
  • #221260 - Line space preservation issue has been resolved While converting a Word document to PDF.
  • #221153 - Inline content control custom XML data is now preserved properly while converting a Word document to PDF.
  • #221725 - The ArgumentOutOfRangeException will no longer be thrown while cloning a Word document.
  • #221611 - The NullReferenceException will no longer be thrown while saving a Word document.
  • #220710 - Table row is now preserved properly while converting a Word document to PDF.
  • #220324 - Checkbox content control state is now preserved properly while cloning a Word document.
  • #221455 - Hanging issue has been resolved while converting a Word document to PDF.
  • #221119 - List number is now preserved properly while opening an RTF format document.
  • #218943 - List bullet is now preserved properly while opening an RTF format document.
  • #221974 - Gray scale recoloring is now preserved properly while converting a Word document to PDF.
  • #219092 - Merge field before and after text is now preserved properly while executing mail merge.
  • #223340 - The IndexOutOfRangeException will no longer be thrown while converting a Word document to PDF.
  • #222852 - Footer content is now preserved properly while merging multiple RTF documents.
  • #223355 - Tab is now preserved properly while converting a cloned Word document to Image.
  • #223510 - Text overlapping issue has been resolved while converting a Word document to PDF.
  • #223931 - The ArgumentException will no longer be thrown while converting a Word document to PDF.
  • #222588 - Formula field result is now preserved properly while updating the Word document fields.
  • #224412 - Hanging issue has been resolved while opening a Word document.
  • #224323, #225518, #225883 - The NullReferenceException will no longer be thrown while calling the GetText API.
  • #224412 - Tab is now preserved properly while converting a Word document to PDF.
  • #223713, #223959 - Hanging issue has been resolved while converting a Word document to PDF.
  • #224287 - Image is now preserved properly while converting a Word document to PDF.
  • #223508 - Word document instance is now disposed properly while converting a Word document to PDF.

PDF

Bug Fixes

  • #224603 - The null reference exception will no longer occur when merging certain PDF documents.
  • #141148 - Tool tip is now preserving properly for PdfSignatureField.
  • #224531 - The null reference exception will no longer occur while saving the merged PDF document.
  • #223013 - The radio button field state is now importing properly from XFDF document.
  • #222779 - Attachment is now opening properly from the merged PDF document.
  • #222024, #224795 - The null reference exception will no longer occur when saving the PDF document.
  • #221122 - PDF security is now preserving properly when saving the PDF document twice.
  • #217591 - Font is now preserving properly in the flattened PDF document.
  • #221424 - The Brush property of the PdfPen is now initialized through the constructor.
  • #219569 - The “Arithmetic overflow exception” will no longer occur while signing the PDF document.
  • #222059 - All hidden layers are now printing properly when saving and loading the PDF document.
  • #221328 - Performance has been improved when saving the uncorrupted PDF document.

Presentation

Bug Fixes

  • #224226 - Application will no more hang while adding an image to a PowerPoint slide.
  • #225390 - PowerPoint file will no longer get corrupted while resaving multiple times with charts.
  • #222440 - Notes in a PowerPoint slide can now be cloned and added to another slide.

SfAutoComplete

Bug Fixes

  • #225122 - Cursor moves to correct position when editing the text in SfAutoComplete.
  • #223673, #225684 - Keyboard does not gets hide when scrolling the drop-down suggestion box in iOS.
  • #132298 - SelectedValue sets correctly when setting dynamically after clearing the text manually in SfAutoComplete.
  • #223621 - Now ValueChanged event works correctly in Android.
  • #223282 - LoadMore works correctly when using ItemTemplate in SfAutoComplete.
  • #221955 - Dynamic setting of BindingContext reflects in ItemTemplate in UWP.

SfBusyIndicator

Bug Fixes

  • #225468 - Animation of SfBusyIndicator works correctly when device goes to sleep mode and come back.

SfButton

Bug Fixes

  • #224983 - Now FontSize property supports Small, Medium and Large Values.
  • #224091 - Now CanExecute method returns CommandParameter values.

SfCalendar

Bug Fixes

  • #224743 – CalendarTapped and SelectionChanged events will be raised while deselect dates when ToggleDaySelection is set as true (UWP).
  • #223789 – BlackOutColor will be applied properly on the current view of SfCalendar (UWP).
  • #222298 - Custom InlineView will be rendered properly in SfCalendar (UWP).

SfCarousel

Bug Fixes

  • #141927 - Carousel works correctly when adding the carousel item dynamically using ItemsSource property.

SfChart

Bug fixes

  • #I223962 – Now, the LegendItemClicked event is triggered even if the ToggleSeriesVisibility is false in the ChartLegend.

  • #I222926 – Now, the legend icon and text color are refreshing properly when collapsing the ChartSeries at runtime in Xamarin.Forms iOS and UWP.

  • #I221062 – Now, the DateTimeAxis labels are updating properly when changing the ItemsSource of the technical indicators.

  • #I218589 – Now, the DateTimeAxis labels are generating without a duplicate label when changing the Israel time zone at runtime in Xamarin.Forms iOS and Android.

SfCheckBox

Bug Fixes

  • #223320 - HorizontalTextAlignment property works correctly when set to End.

SfChipGroup

Bug Fixes

  • #226151 - Now, item gets selected on first click and Two way binding works correctly on SelectedItems property

SfCircularGauge

Bug fixes

  • # 225194, #141805 – CircularGauge Header text size will be applied properly in Xamarin.Forms for Android.
  • # 221969 - Gauge will be rendered properly when dynamically change the its view in Xamarin.Forms for UWP.

SfComboBox

Bug Fixes

  • #225622 - ComboBox works correctly when changing the content view dynamically.
  • #225678 - CustomView is working correctly in SfComboBox
  • #225387 - Now DisplayMemberPath property works correctly and Delimeter mode works correctly when selecting multiple items in UWP.
  • #223402 - SelectedDropDownColor works correctly when changing the SelectedItem dynamically.
  • #141799 - Clear method works correctly when calling dynamically in Token mode.
  • #224167 - Clicking the Clear button clears the value in Editable mode in iOS.
  • #223668 - ComboBox works correctly when placed inside the DataTemplate of ListView in Android.
  • #223019 - FooterView of ComboBox works correctly after upgrading the Xamarin.Forms version to 4.x pre release.
  • #221800 - Keyboard closed correctly when setting the focus to SfComboBox control when navigating the from one page.
  • #221132 - Clear button does not appears when the SfComboBox control is not in the focus for initial selection
  • #221325 - IsSelectedItemsVisibleInDropDown property works correctly and on setting BackgroundColor property, it fill the whole control in iOS.
  • #221115 - FontFamily property works correctly in SfComboBox in Android.
  • #220394 - The selected item text displays correctly when the text length is long in SfComboBox

SfDataForm

Bug Fixes

  • #223728 – The DataForm Picker ItemSource refreshes properly when updated at runtime.
  • #224316, #225952 – Now, the UpdateEditor method is working properly.
  • #223279 – Now, gray color is applied for PlaceHolderText in Multiline editor (iOS).
  • #225041, #142134, #225914 – The ObjectDisposedException is no longer thrown when data form is added to the navigation page (Android).

SfDataGrid

Bug Fixes

  • #223708: The NullReference exception no longer occurs when loading the SfDataGrid with ScrollingMode as PixelLine.
  • #224519: The NullReference exception is no longer thrown when navigating from one page to another and ItemsSource is set in the OnAppearing override.
  • #223888: In edit mode, when clicking any key for the first time, the text selection does not change and only the value is changed in UWP.
  • #225557: Application does not crash when scrolling the grid horizontally with UnBoundRow.
  • #224177: The custom sort icon does not overlap with the Header text in Xamarin.Forms.iOS
  • #141551: The TableSummary row text aligns at the center when TextAlignment is set to center with LoadUiView set to false.
  • #222691: Issue with, “Column dragging will not occur when e.Cancel is set to true for a particular column” has been fixed.
  • #218212: GridNumericColumn format is now applied properly.

SfImageEditor

Bug fixes

  • #141991 - Path shape thickness will be updated while adding the path shape with customized stroke thickness using the AddShape method.

  • #223574 - Rectangle shape will no longer exceed the boundary of the SfImageEditor.

SfKanban

Bug fixes

  • #I219845 – Now, the Kanban card is fitted correctly based on the column width when clearing the Columns property at a run time in Xamarin.Forms Android.

SfLinearGauge

Bug fixes

  • # 215230 - LinearGauge will be rendered when setting minimum size((below 100) in Xamarin.Forms for UWP.
  • # 224262, #226639 - Annotation view will be displayed when setting control elements(like label, button) inside the layouts.

SfListView

Bug Fixes

  • #225971 - The SelectedItems collection will be updated properly without duplication when the SelectAll method is called multiple times.
  • #225385 - The Null reference exception will no longer occur when the DataSource is set to null before loading the items.
  • #223655 - The “Argumentative exception” will no longer occur when removing an item if the SfListView has one item, and ScrollToRowIndex is applied to the loaded event.

SfMaps

Bug fixes

  • # 222606, #141389 – MarkerTemplate binding will be worked, when changing the MarkerTemplate dynamically.
  • # 141437, #222839 – The KeyNotFoundException will no longer thrown while changing the Marker collection.

SfMaskedEdit

Bug Fixes

  • #223297 - Now we can customize the WatermarkFontAttributes in iOS.

SfNavigationDrawer

Bug Fixes

  • #221284, #225329, #225972 - Content view of SfNavigation drawer is displayed correctly on rotating the device.
  • #223437, #224621 - Navigation from one page to NavigationDrawer and goes back it works correctly.
  • #222826 - Toggled event and Closed event returns correct value on closing and opening the secondary drawer.
  • #221535 - Now drawer content view is displayed based on the given height in iOS.

SfNumericTextBox

Bug Fixes

  • #223568 - NumericTextBox works correctly when placed inside flex layout in iOS.
  • #222710 - Keypad displays correctly in SfNumericTextBox in Tablet
  • #220904 - Cursor position is placed correctly when type zero after dot.
  • #220995 - Minus key works correctly when setting Swedish culture.
  • #220512, #224972 - Minus key renders correctly in SfNumericTextBox in iOS.

SfNumericUpDown

Bug Fixes

  • #224330 - NumericUpDown increment button works correctly when it is placed inside SfListView.
  • #219201 ,#221058 - NumericUpDown spin button aligns correctly.

SfPdfViewer

Bug Fixes

  • #225315 - PDF document will now be loaded when you download it from URL using WebClient.
  • #223801 - Page navigation will work properly when using the GotoPage API.
  • #224216 - Application will no longer crash while setting a value to the PageNumber property in SfPdfViewer.
  • #224628 - PDF document will now be displayed properly when placing PDF Viewer in popup page and disabling the built-in toolbar.
  • #F141550 - Application will no longer crash when loading a PDF document on placing PDF Viewer in popup page and disabling the built-in toolbar.
  • #221019 - Text search functionality will now work properly in SfPdfViewer.
  • #218802 - Collection modified exception will no longer be thrown when toolbar visibility is set to true in an XAML page.
  • #221854 - PDF document will now be loaded properly when passing a stream which could not be sought, into SfPdfViewer.
  • #202982 - SfPdfViewer is now displayed without errors in XAML previewer for Xamarin.Forms.

SfPicker

Bug Fixes

  • #221904 - Dynamic collection update works correctly on SfPicker in iOS.
  • #221828 - Picker works correctly when loading empty collection.

SfPopupLayout

Bug Fixes

  • #222662: The SfPopupLayout.Content constructor is now called only once when the pop-up is displayed.
  • #214331: Pop-up overlays in full screen during orientation changes if HorizontalOptions and VerticalOptions are set to FillAndExpand.
  • #223056, #226001, #226264: Pop-up comes to the view when IsOpen property is bound in Xamarin.Forms.Android.

Behavior Changes

  • # When using SfPopupLayout in MVVM Cross above version 6, initialize the renderer code Xamarin.Forms.Android renderer like the SfPopupLayoutRenderer.Init(this).
  • # Default background color for PopView is now changed from Transparent to White.

SfPullToRefresh

Bug Fixes

  • #141242: Pulling is triggered properly in the second page even after scrolling down the listview in the first page.

SfRadialMenu

Bug Fixes

  • #222444 - CenterButton works correctly on clicking in SfRadialMenu.
  • #220214 - Text gets shown when using custom view for SfRadialMenuItem.

SfRangeSlider

Bug Fixes

  • #222437, #213332 - SfRangeSlider responds correctly on using StepFrequency property in iOS.

SfRating

Bug Fixes

  • #224213 - Now Style gets applied when customizing the properties in RatingSettings class.
  • #194226, #221464, #221515 - SfRating control displays in centre when placed inside StackLayout.

SfSchedule

Bug Fixes

  • #225231, #141968 - Recurring appointments will occur properly when RecurrenceRule is set.
  • #225002 – The month view will not be navigable when selecting previous or next month dates and dynamically changing the FirstDayOfWeek in SfSchedule (Android and iOS).
  • #223491, #224875 – RecurrenceCount and WeekDays values of RecurrenceProperties will return the correct value in SfSchedule.
  • #219122 - Appointment blinking issue has been resolved when dropping custom view appointments in a new location (iOS).

Breaking Changes

  • BYDAY recurrence rule behavior has been changed as per the standard (e.g., TH, SU, MO, etc.) in SfSchedule.

SfSegmentedControl

Bug Fixes

  • #223132 - IsEnabled property works correctly when SegmentedControl is used as custom control.
  • #221895 - SfSegmentedControl renders correctly when placed inside the ItemTemplate of SfListView.
  • #220984 - SelectedItem position is updated correctly on changing the ItemsSource dynamically.

SfTabView

Bug Fixes

  • #224673 - FontIconFontColor property works correctly in SfTabView.
  • #224504 - Now contents of the tab item is appeared correctly on rotating the device in RTL mode.
  • #225111, #225138,#225163 - Now we can remove the tab items dynamically from the SfTabView in iOS.
  • #220604, #220986, #221581, #223150 - Now SfBusyIndicator works correctly inside TabView
  • #224010 - SfRotator images are displayed correctly inside the SfTabView content on using prism.
  • #223110 - SfListView content renders correctly inside SfTabView in android.
  • #223772 - Now SfTabView works property without declaring Content property.
  • #223010, #223401 - TabView content displays correctly when rotating the device in android.
  • #221821 - Selected index updates correctly when swiping in android.
  • #216685 - Tab header item align correctly on setting ImageWithText as DisplayMode in android

SfTextInputLayout

Improvements

  • #I223690 - Support has been extended to Android 4.4 (API 19) for SfTextInputLayout.

Bug fixes

  • #F141868 - Hint and the placeholder text will now be displayed at their allocated positions at load time.
  • #F141748 - Hint floats properly when removing and adding the same instance of the view in layouts.
  • #I223411,#I225464 - The control will be aligned properly when SfTextInputLayout is placed inside FlexLayout with different types of layout hierarchy.

SfTreeView

Bug Fixes

  • #224278 - RootNode collection will be updated properly when the ItemsSource is set at run time.

XlsIO

Breaking Changes

  • #222797 - AutoDetectComplexScript has been added in XlsIORendererSettings class to support complex script rendering in Excel to PDF conversion

Bug Fixes

  • #223667 - Exception no more thrown if chart’s data range column is deleted.
  • #225065 - Currency number format is now properly detected in XlsIO generated Excel File.
  • #224023 - Exception thrown while opening an XlsIO re-saved document with group shape is resolved.
  • #223946 - Conditional format is now preserved properly while saving the workbook multiple times.
  • #223839 - Infinite recursive loop on saving an Excel file after modifying chart data range with the improper series indices is resolved.
  • #224024 - Not implemented exception thrown while opening an Excel document external formula range in check box is fixed.
  • #223448 - Pivot table field settings are properly preserved on re-saving the Excel file.
  • #223167 - Custom time format [h]:mm:ss is now detected automatically.
  • #223376 - Exception occurs while saving Excel document with OLE object is resolved.
  • #223226 - NullReferenceException thrown while resaving an Excel file to HTML is fixed.
  • #223041 - Data validation formula is preserved proper while saving as XML.
  • #221229 - Issue with pivot field values due to improper pivot field data format, is resolved.
  • #214445 - Table.Refresh() is now working proper with ODBC connection.
  • #223918 - Conditional format is now preserved properly on converting Excel document to PDF.
  • #223859 - Hyperlink is now set properly in Excel to PDF conversion.
  • #221079 - Exception thrown if print-title row height is higher in Excel to PDF conversion, is fixed.
  • #221693 - Parameter invalid exception thrown while converting Excel document into PDF is fixed.
  • #222797 - Incorrect Thai font in Excel to PDF conversion is fixed.
  • #F141101 - Issue with incorrect parsing of comment is resolved.
  • Issue with Conditional formatting operator type is incorrect in re-saved Excel document is fixed.
  • Setting a table column header name no longer corrupts the Excel.
  • DataBar color is now applied proper for negative values.
  • External formula is applied proper in NET Standard.