Essential Studio for Xamarin.Forms Release Notes

v16.3.0.29
October 30, 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

DocIO

Bug Fixes

  • #216566 - The file will no longer be corrupted while adding Chart into a Word document (DOCX).
  • #215421 - Paragraph list is now preserved properly while merging a cloned paragraph with ImportOptions.KeepSourceFormatting.
  • #F139944, #215539 - Custom UI is now preserved properly while opening and saving a Word document (DOCX).
  • #214749 - The “FormatException” will no longer be thrown while opening a Word document.
  • #214664 - Table cell content is now preserved properly while converting a Word document to PDF.
  • #213886 - List number is now preserved properly while opening and saving a Word document (DOCX).
  • #F139508 - Page border position is now preserved properly while converting a Word document to PDF.
  • #213327 - Shape is now preserved properly while converting a Word document to PDF.
  • #213151 - Bullets are now preserved properly while merging the Word documents.
  • #213042 - Unexpected frame preservation issue has been resolved while calling the WordDocument.Replace API for Word document.
  • #212593 - Text wrapping issue has been resolved while converting a Word document to PDF.
  • #212502 - Textbox is now preserved properly while converting a Word document to PDF.
  • #210586 - The “NotSupportedException” will no longer be thrown while converting a HTML document to Word document.
  • #182512 - The “OutOfMemoryException” will no longer be thrown while opening a Word document.

PDF

Bug Fixes

  • #215133 - Performance has been improved when accessing the PDF document layers.
  • #210943, #216074 - String was not recognized as a valid DateTime exception will no longer occur while loading a PDF document.
  • #215941 - Barcode is now preserving with proper size when specifying the size of a barcode.
  • #215595 - The 1D barcode is now scanning properly with default width.
  • #215096 - FNC characters in the given input is now preserving properly for PdfGS1Code128Barcode.
  • #215166 - The Null-reference exception will no longer occur while loading a PDF document.
  • #214918 - Light table header is now preserving properly when providing the data source through IEnumerable.
  • #214401 - The ArgumentException will no longer occur when loading a PDF document.
  • #217007 - The Null-reference exception will no longer occur when importing pages from the PDF document.

Presentation

Bug Fixes

  • #207078 - The FormatException will no longer be thrown while resaving a PowerPoint document with formulated path points.

SfAutoComplete

Bug Fixes

  • #207976: Now, DropDown items scrolling works properly with ItemTemplate.
  • #216036: The SuggestionBox opens above the SfAutoComplete when the SuggestionBoxPlacement is set to top.
  • #216856: The Clear button in SfAutoComplete is properly aligned in Android.

Breaking Changes

  • The default height of the control is changed to 30 in Xamarin.Forms iOS.
  • The default text size of the control is changed to 17 in Xamarin.Forms iOS.

SfBusyIndicator

Bug fixes

  • #217071: The SfBusyIndicator is properly aligned at the center in UWP.

SfCalendar

Bug Fixes

  • #217171- The issue with selecting the first day of a week in SfCalendar on real iPhone 8 plus device has been fixed (iOS).
  • #F140248- The custom view will be applied properly when setting through the OnInlineLoaded event (UWP).
  • #F139032,217023- The EventToCommand behavior will be worked properly on the OnMonthCellLoaded event in SfCalendar.
  • #216520- The issue with calendar visibility when coming back to the month view from year view has been fixed (iOS).
  • #216520- The weekend background color will not be removed when using the OnMonthCellLoaded event in SfCalendar (UWP).
  • #F140113- The DateSelectionColor will work dynamically in SfCalendar (Android) (iOS).
  • #214362- - Memory leak has been reduced while using month view CellTemplate in SfCalendar (iOS).
  • #215948- The SelectionColor will be cleared properly in SfCalendar (Android).
  • #F140248- The OnInlineLoaded event will be fired when selecting a date which do not contain appointments and properly applied custom view (Android).
  • #F139330,214362,216376,217372,218533 - The SfCalendar crash will be resolved when using updated Xamarin.Forms version (iOS).
  • #215508,216449- The RangeSelection will work properly when selecting a range through dragging (iOS).
  • #215380- SfCalendar will be rendered properly when handling Visibility and Async operations (Android).
  • #214680- The month animation will work properly when navigating through left navigation arrow (UWP).
  • #216520- The YearView mode will work properly when changing dynamically (UWP).
  • #216805- The custom view will be rendered properly when maximizing or minimizing SfCalendar (UWP).
  • #215380,215948,217639- The initial rendering performance have been improved when using custom view in SfCalendar (Android).

Breaking Changes

  • The OnMonthCellLoaded event arguments MonthCell have been derived from EventArgs and it is obsoleted. Use MonthCellLoadedEventArgs instead of MonthCell arguments. The following APIs are obsolete in the OnMonthCellLoaded event arguments:
    • MonthHeaderTextColorProperty
    • MonthHeaderBackgroundColorProperty
    • MonthLayoutBackgroundColorProperty
    • TextColorProperty
    • FontProperty
    • FontFamilyProperty
    • FontAttributeProperty
    • ViewProperty
  • The OnYearCellLoaded event arguments YearCell have been derived from EventArgs and it is obsoleted. Use YearCellLoadedEventArgs instead of YearCell arguments. The following APIs are Obsolete in the OnYearCellLoaded event arguments:
    • BackgroundColorProperty
    • TextColorProperty
    • BorderColorProperty
    • FontProperty
    • FontAttributeProperty
    • FontFamilyProperty
    • ViewProperty
    • CellTemplateProperty
    • CellBindingContextProperty
    • IsCurrentMonthProperty

SfChart

Bug fixes

  • #F140237 – The ColumnSeries will be rendered properly when the SideBySideSeriesPlacement property is set to false along with date time axis is hourly data.

  • #I215628 – The SelectionChanging event is appropriately triggered when tapping the segment in Xamarin.Forms UWP.

  • #I214214 – Now, the data point selection properly disappears when setting the SelectedDataPointIndex property to -1 at run-time in Xamarin.Forms Android and UWP.

  • #F138735, I212753 – Now, the width of the legend ItemTemplate can be changed dynamically in Xamarin.Forms Android and iOS.

  • #I214382, I214320 – The chart axis label appears properly in all the time zones in Xamarin.Forms iOS.

  • #I214942 – The FontSize of the legend works properly while toggling the series at run-time in Xamarin.Forms Android.

  • #F139579 – Now, the ViewAnnotation BindingContext property is working properly at run-time in Xamarin.Forms iOS, macOS and UWP.

SfCheckBox

Bug fixes

SfCircularGauge

Bug fixes

  • # 139647 - The gradient colors for Ranges will be applied properly even on dynamic change of range StartValue and EndValue.

  • # 140149 - The Thickness of NeedlePointer will no longer change on page navigation in Xamarin.Forms for iOS.

SfComboBox

Bug Fixes

  • #F140320: Now, the Token is properly aligned when setting the MultiSelectionMode and TokenWrap modes to Wrap in UWP.
  • #211829, #212246: The DropDownFooterView is properly working in UWP.
  • #211944, #215145: Now, the Text is properly updated when setting the small size Width in Android and aligned as center when using token mode in UWP.
  • #215230: Now, the touch action will be handled using the DropDownHeader and DropDownDownFooter views.
  • #216011, #216279: The SelectedItem is working properly when setting into multiple Combo box in UWP.

SfDataForm

Bug Fixes

  • #216428 – The ArgumentException will no longer be thrown when passing a custom SourceProvider which is to be used as a foreign key in the data form picker editor.
  • #139989 – The data form label icons will be rendered properly when set FastRenderers_Experimental flag in the activity.

SfDataGrid

Bug Fixes

  • #121394 : Grid not loaded while binding columns collections to SfDataGrid.ColumnsProperty from sample. This issue is fixed.
  • #140380 : Datagrid generates “SetValue: Can not convert value to type ‘System.String’” errors in the output window, when having the double property type in model (No compilation errors obtained and grid will be rendered). This issue is fixed.

SfDateTimeRangeNavigator

Bug fixes

  • #I215905 – The “NullReferenceException” will no longer be thrown when adding SfDateTimeRangeNavigator to the stack/grid layout by collapsing the layout visibility in iOS.

SfDiagram

Bug Fixes

  • #214069 - Now,SaveAsImage method works properly when node aligned on negative offsets.

SfImageEditor

Bug fixes

  • #I217783 - Now, NSInvalidArgumentException will no longer be thrown when deploying app in iOS 9 version.

  • #I216825 - Now, Text Previewer Window will not crop in iOS device.

  • #I216344 - Now, Null Exception will no longer be thrown when move custom view after add shape as path in Android.

  • #F140493 - Now, image editor will load image from drawable resource in Android.

SfKanban

Bug fixes

  • #F139191, I215767, I216484 - The “ArgumentOutOfRangeException” will no longer be thrown from the OnClick method of KanbanItemViewHolder class in the Android platform.

  • #I217230 – The “ArgumentOutOfRangeException” will no longer be thrown when tapping the card in Android.

SfLinearGauge

Bug fixes

  • # 215230 - Pointers defined in each scale will be animated when multiple scales are used in Xamarin.Forms for iOS.

  • # 216701, #216355 - Annotations point to the exact specified ScaleValue even if the LinearScale is specified in negative ranges in Xamarin.Forms for iOS.

  • # 213816 - Multiple scales will work properly in Xamarin.Forms for UWP.

SfListView

Bug fixes

  • #218175 - The SelectedItems collection gets updated properly when clearing through binding at runtime.
  • #216968 - The Margin property values are updated properly after scrolling when bound to the parent element in ItemTemplate.
  • #216711 - The drag-and-drop operations will work properly when the Gesture is set to the parent element in Android platform.
  • #214427, 217830 - In UWP, scrolling will work properly when using mouse wheel and touch pad by two fingers in Xamarin.Forms v3.1.

SfMaps

Bug fixes

  • # 140183 – The [EndOfStreamException] will no longer be thrown when using dbf files with large set of records in Xamarin.Forms for Android.

  • # 140109 - Selection works properly in iOS 12 as in previous versions.

Features

  • # 213053 – Support has been provided for loading map shape files as stream.

SfNavigationDrawer

Bug Fixes

  • #214956: Now, the SfNavigationDrawer is properly measured in iPhone-X models and items in the DrawerContent are properly updated.

SfNumericTextBox

Bug fixes

  • #214882 - Now, the value can be set to zero when the AllowNull property is set to True.

  • #216494 - The Next button will now work properly when using multiple text box.

SfNumericUpDown

Bug fixes

  • #217064 - The decimal values will be now displayed properly when setting culture in iOS.

  • #F140026,#216028,#217744 - The BackgroundColor property can now be updated dynamically in UWP.

  • #215822 - The height will no longer be cropped when applying value less than minimum height.

  • #213074 - The decimal digits will be displayed properly when setting MaximumDecimalDigits property value as zero in UWP.

SfPdfViewer

Bug Fixes

  • #215049 - Hyperlinks will work properly after zooming the PDF document through SfPdfViewer.
  • #212692 - Read-Only annotations in a PDF document could not be edited.
  • #F139301 - SfPdfViewer will load properly when the built-in toolbar is disabled.
  • #214327, #212608 - Memory consumption is reduced when loading a PDF document.
  • #212608 - Application will never hang when loading a PDF document.
  • #216201 - The TextMarkup annotation is now working properly when the IsTextSelectionEnabled property is set to false.
  • #216201, #215755 - The System.NullReferenceException will no longer be thrown when added as a child of StackLayout in Xamarin.Forms.UWP.
  • #213897, #215453 - Black screen will not be displayed while loading a PDF document in SfPdfViewer in Xamarin.Forms.iOS.
  • #212904 - The TextMarkup annotation is now working properly when loading a PDF document.
  • #216201 - The System.InvalidOperationException will no longer be thrown when visibility of SfPdfViewer set to false.
  • #218657- Initial loading time to display the PDF document is reduced , when loading the document in OnAppearing() method

SfPicker

Bug fixes

  • #F139158: SfPicker touch issue has been fixed in Dialog Mode .
  • #208189, #215703, #216545: SelectionChanged event argument value get update properly.
  • #213074: The Cascading picker working properly when adding the items dynamically.
  • #213074, #217012: Now, the SfPicker is working properly when removing a column dynamically.
  • #216871: The SelectedItem is working properly in Android.
  • #217298: The SfPicker is working properly when using with the latest Xamarin.Forms.

SfPopupLayout

Bug Fixes

  • #213979 : Popup layout mislead at some points in y position while using ShowAtRelativeToView method. This issue is fixed.
  • #212138, #216676, #216833 : Popup layout mislead at some points in y position while using ShowAtRelativeToView method with the SfTabView when passing Absolute X and Absolute Y position. This issue is fixed.
  • #217120 : Popup crashes when Header Template is set and popup is closed. This issue is fixed.
  • #216918 : App crash while change the orientation with popup layout. This issue is fixed.
  • #204788, #214331: Popup is not overlay in full screen when height and width is set as Nan. This issue is fixed.
  • #216676 : Popup is not displayed if custom views is loaded in SfPopupLayout.PopupView.ContentTemplate. This issue is fixed.
  • #216693, #216833 : Outer border is not drawn in top and bottom of the Popup in the iOS platform in Xamarin.Forms. This issue is fixed.
  • #216833 : Sample crashes if SfPopupLayout.PopupView.AnimationMode is set and popup is closed by touching outside the popup. This issue is fixed.

SfProgressBar

Bug fixes

  • #215751 - NullReferenceException is no longer thrown from the HideSubLayer method of SfLinearProgressBar class in iOS.

  • #214446 - ObjectDisposedException will no longer be thrown while binding the IsVisible property.

SfRadialMenu

Bug Fixes

  • #216121: Now, the IsOpen property is working properly in iOS.

SfRadioButton

Bug fixes

  • #217523 - Now,the TextColor property is working properly in iOS.

  • #217603 - The SfRadioButtonRendererclass is exposed as public for customizing the color of the radio button while holding.

  • #214301,#217684 -The SfRadioButton is getting selected properly when combined as radio group.

  • #214213 - The SfRadioButton will no longer crash when setting CheckedColor and UnCheckedColor properties in Android version 4.4 with API level 19.

  • #216397,#217340,#217523 - The BackgroundColor property is now working properly in SfRadioButton.

SfRangeSlider

Bug Fixes

  • #212357: The RangeStart and RangeEnd Properties are working properly in UWP.
  • #216215: Custom label is properly updated when setting the maximum value in Android and iOS.

SfRating

Bug Fixes

  • #138707, #213617, #213962, #215061: Now, the SfRating control height is updated properly in UWP when it is used inside SfListView control.

SfRotator

Bug Fixes

  • #F139052: The SfRotator view gets update properly when add/remove a view.
  • #212802: The Items are loaded properly when swiping in iOS.
  • #216992: The SfRotator working properly when navigating back to SfRotator page from another Content page.

SfSchedule

Bug Fixes

  • #215470 - The NullReferenceException will no longer be thrown when more than one schedule instances are maintained and one schedule will be disposed when navigating to other (iOS).
  • #216068 – The current month will be shown in the header of the first day of a month when using time zone with daylight savings.
  • #207109 – The ListView will scroll properly in the month inline custom view (iOS).
  • #139997 – The custom views provided in the events and DataTemplate will be rendered properly for the month inline custom view (Android).
  • #138494 – The day view will be moved to the next or previous day properly when dragging an appointment (UWP).

Features

  • #213346 - Support to get the list of appointments displayed in visible date range.

SfSegmentedControl

Bug Fixes

  • #214500: The SelectedIndex property is updated properly in UWP.
  • #216928, #217004, #F140185: The FontIconFontColor property is working properly in Android.

SfTabView

Bug fixes

  • #F139450, #F139642, #F139762, #215903: Now,the content of SfTabItem is appeared when switching the tab placed inside a ContentView.
  • #215230: The SelectionChanging event is triggered only once when navigating to another tab in iOS.
  • #215686: Now SfTabView supports for Global-CSS Style.
  • #217912, #218171: The SelectedIndex property of two-way binding is working properly in iOS.

SfTextInputLayout

Bug fixes

SfTreeView Preview

Bug fixes

  • #216064 - In Forms.iOS, the exception will no longer be thrown when setting the SelectedItems property to null.
  • #217314 - The exception will no longer be thrown when changing the ItemsSource continuously at runtime.
  • #215696 - In Forms.Android, the exception will no longer be thrown when loading SfTreeView inside the MasterDetailsPage.

XlsIO

Bug fixes

  • #139653 - Issue with VLOOKUP formula while setting custom separators in German culture is fixed.
  • #204947 - Exception thrown while opening Excel document with duplicate attributes is resolved.
  • #212300 - Null reference exception is no longer thrown while add copying the workbook with invalid sheet references.
  • #212300 - File corruption issue while copying a range having named range formula referring to External workbook is resolved.
  • #213242 - Chart default axis title area text settings and text box properties are now cloned properly in XlsIO.
  • #213274 - StandardHeight is now properly set for XlsIO generated Excel documents.
  • #213608 - Incorrect RichText format while saving the Excel document is fixed.
  • #213658 - Null reference exception thrown while getting ListOfValues property of Data Validation is fixed
  • #213658 - NumberFormatSettings returning null value while accessing particular range is fixed.
  • #213658 - Issue with FirstFormula property of Data Validation in binary Excel files is fixed.
  • #213819 - DeleteColumn method works properly for CSV file.
  • #214098 - Issue in setting Maximum labels count for chart numeric axis in chart to image conversion is fixed.
  • #214495 - Issue with slicer getting removed on saving the file in Excel 2007 version is fixed.
  • #214638 - Excel file with incorrect anchor type for shapes is resaved properly without any corruption.
  • #214638 - Excel file with text box is resaved properly in Excel 2007 version without any corruption
  • #214879 - Exception thrown while parsing the named range formula without worksheet reference is resolved.
  • #214915 - Enabling WrapText property will no longer throw exception during BeginUpdate().
  • #214924 - Excel file with conditional formats is resaved properly without any corruption.
  • #215001 - Issue with horizontal alignment for textbox is resolved.
  • #215030 - Null reference exception thrown on casting chart data label as text area on parsing Excel file is fixed.
  • #215185 - Text box color and macro link are properly resaved in the Excel document.
  • #215197 - Issue with changing legend position from manual layout is fixed.
  • #215350 - Special characters (Ampersand and less-than symbols) can be used in HTMLString property without any exception.
  • #215591 - Issue with copying borders in merged cells is fixed.
  • #216094 - ArgumentException thrown while assigning “/” as cell value is fixed.
  • #216187,* #214895 - Performance issue while inserting rows is resolved.
  • #216305 - AutoFitColumn now works properly for currency values.
  • ArgumentException thrown while accessing used range having styles alone is fixed.
  • Border set to a cell through BordersAround method is now applied properly.
  • Unhandled exception thrown while opening an Excel file with duplicate shape attribute is fixed.