Essential Studio for Xamarin.Forms Release Notes

v17.2.0.34
July 11, 2019

Common

  • UI Templates have been removed from the installer and will be available as a separate package in upcoming weeks.

DocIO

Features

  • #227695, #144419, #129497, #F136030, #118915 – Added group shapes support in DOCX to PDF conversion.
  • #217347, #237135 - Added support to perform Mail merge using ADO.NET Objects.
  • #227388 - New event has been added to customize clearing each unmerged merge fields during Mail merge.
  • #208057 - Added support for warnings to show unmatched merge fields and groups during Mail merge.
  • #209444 - API has been added to access the new instance (WPicture or WTextRange) to be replaced in Mail merge event arguments.
  • #208534 - API has been added to update the Word document fields while converting a Word document to PDF.
  • #222516,#206993,#204167,#209466,#212256,#205172,#209881,#213951,#224611,#225399,#236070,#220198,#205172 - RTL text rendering algorithm has been improved in Word to PDF conversion.

Bug Fixes

  • #233421 - Empty paragraph preservation issue has been resolved while replacing text with table.
  • #232599 - The ArgumentOutOfRangeException will no longer be thrown while opening an RTF format document.
  • #231722 - HTML end tag is now preserved properly while converting a Word document to HTML format document.
  • #231594 - Dropdown form field is now preserved properly while converting an HTML to RTF format document.    
  • #225752,#230460,#230460 - Line space preservation issue has been resolved when updating the Word document fields.
  • #F142931 - The DocProperty value is now preserved properly while converting a Word document as PDF.    
  • #219214,#228161 - Merge field is now properly updated while executing Nested Mail merge.
  • #233913 - Right to left text is now preserved properly in DOCX to DOCX conversion.
  • #232775 - Header and Footer contents are now preserved properly in XML to DOCX format conversion.
  • #232718 - The Content control text is now preserved properly in DOCX to Text format conversion.
  • #F143772 - Nested bookmark is now preserved properly while opening a DOC format Word document.
  • #F143774 - Table cell contents are now preserved properly while applying horizontal merge to the table.
  • #232505 - Font is now preserved properly while converting a Word document to PDF.
  • #232502 - Content is now preserved properly while converting an RTF to HTML format conversion.
  • #232265 - Spacing issue has been resolved while converting an HTML to DOCX format document.
  • #231592 - TOC content is now preserved properly while updating table of content in Word document.
  • #231721 - The NullReferenceException will no longer be thrown while converting a Word document to PDF.
  • #226490 - Corruption issue has been resolved while saving the DOCX format Word document.
  • #F143006 - Text is now preserved properly while replacing the bookmark content in DOC format document.
  • #228442 - Table alignment is now cloned properly while cloning the Word document.
  • #228370 - Table styles are now preserved properly while converting an HTML to DOCX format document.
  • #226490 - Corruption issue has been resolved while saving the DOC format Word document.
  • #230678, #228611 - The NullReferenceException will no longer be thrown while converting a Word document to PDF.
  • #229685 - Table border is now preserved properly while converting a Word document to PDF.
  • #229738 - Text is now preserved properly while converting a Word document to PDF.
  • #231056 - Border is now preserved properly while converting a Word document to PDF.
  • #231712 – The NullReferenceException will be no longer thrown while updating fields in the Word document.
  • #231056 - Text overlapping issue has been resolved while converting a Word document to PDF.
  • #F142888, #229094 - Table cell borders are now preserved properly while converting a Word document to PDF.
  • #228272 - Table border is now preserved properly while converting an RTF format document to PDF.
  • #227754 - Multiple TOC page numbers are updated properly while calling the UpdateTableOfContents method.
  • #231550 - Performance has been improved while converting a Word document to PDF.
  • #231426 - Hanging issue has been resolved while converting a Word document to PDF.
  • #229685 - Font is now embedded properly while converting a Word document to PDF.
  • #229891 - Hanging issue has been resolved while converting a Word document to PDF.
  • #228974 - Ref field result is now preserved properly while updating the Word document fields.
  • #228974 - Unknown field result is now preserved properly while updating the Word document fields.
  • #228968 - Hanging issue has been resolved while updating the Word document fields.
  • #231751 - Space is now preserved properly while converting a Word document to PDF.
  • #227429 - Border is now preserved properly while converting a Word document to PDF.
  • #228386 - Text with capital style is now preserved properly while converting a Word document to PDF.
  • #228319 - Page border is now preserved properly while converting a Word document to PDF.
  • #212671, #212772, #220859, #230072, #232381 - List style name is now updated properly while opening and saving a Word document.
  • #228049- Image position is now preserved properly while saving an RTF format Word document.
  • #231842- Content control text formatting is now preserved properly while parsing DOCX document.
  • #234841 - Watermark is now preserved properly while opening a DOC format Word document.
  • #235667 - Data inside the table is now preserved properly while updating alternate chunks in a Word document.
  • #231056 – IF field text is now preserved properly while converting a Word document to PDF.
  • #231677 - Image is now preserved properly while saving a Word document.
  • #228049- Table left indent value is now preserved properly while opening an RTF document.
  • #234817 - Text color is now preserved properly while resaving a Word document.
  • #234270 - Content control text is now preserved properly while converting a Word document to PDF.
  • #234335 - Table preservation issue has been resolved while opening and saving a Word document.
  • #228049 - Header and Footer distance is now preserved properly while saving an RTF format Word document.
  • #231431 - The System.OverFlowException will no longer be thrown while saving a DOCX format Word document.
  • #234971 - Table cells are now preserved properly while converting a Word document to Image.
  • #234698 - The ArgumentOutOfRangeException will no longer be thrown while converting a Word document to PDF.
  • #234693 - Hanging issue has been resolved while converting a Word document to PDF.
  • #233642 - The NullReferenceException will no longer be thrown while converting an RTF to PDF.
  • #231056 - Spacing issue has been resolved while converting a Word document to PDF
  • #230817 - Table cell is now preserved properly while converting a Word document to PDF.
  • #232331 - Shape is now preserved properly while converting a Word document to PDF.
  • #234841 - Tab is now preserved properly while converting a Word document to PDF.
  • #234972 - Table is now preserved properly while converting a Word document to PDF.
  • #234972 - Pagination issue has been resolved while converting a Word document to PDF.
  • #234841 - Table is now preserved properly while converting a Word document to PDF.
  • #233810 - Text is now aligned properly while converting a Word document to PDF.
  • #233810 - Picture is now preserved properly while converting a Word document to PDF.
  • #232331 - Text is now preserved properly while converting a Word document to PDF.
  • #232770 - The NullReferenceException will no longer be thrown while converting a Word document to PDF.
  • #229546 - Text is now preserved properly while converting a Word document to PDF.
  • #231056 - Spacing issue has been resolved while converting a Word document to PDF.
  • #234409 - Frame content is now preserved properly while converting a Word document to PDF.
  • #236156 - Pagination issue has been resolved while converting a Word document to PDF.
  • #236611 - Footnote is now preserved properly while converting a Word document to PDF.
  • #236070 - Parentheses are now preserved properly while converting a Word document to PDF.
  • #236156 - Hanging issue has been resolved while converting a Word document to PDF.
  • #235770 - Checkbox symbol is now preserved properly while converting a Word document to PDF.
  • #233383 - Memory usage is now optimized while converting a Word document to PDF with Chinese text.
  • #234978 - Table is now preserved properly while converting a Word document to Image.
  • #228049 - Text alignment is now preserved properly on RTF to RTF conversion.
  • #227205, #225752 - IF field’s field result is now preserved properly while updating the Word document fields.
  • #228049 - Text font size is now preserved properly on RTF to RTF conversion.
  • #F142273, #F143006 - Bookmark contents are now removed properly when deleting the bookmark content.
  • #234089 - The NullReferenceException will no longer be thrown while applying list style to the paragraph using ApplyStyle API.
  • #236762 - The IndexOutOfRangeException will no longer be thrown while opening an RTF format Word document.
  • #236762 - The ArgumentOutOfRangeException will no longer be thrown while opening an RTF format Word document.
  • #236305 - Paragraph left indent is now preserved properly while converting a Word document to HTML.
  • #236840 - The IndexOutOfRangeException will no longer be thrown while opening a Word document.
  • #236840 - Document corruption issue has been resolved while saving the DOCX format Word document.
  • #F145154 - Bookmark is now preserved properly while removing table column.
  • #236840 - List value is now preserved properly while converting a Word document to PDF.
  • #234978 - Table splitting issue has been resolved while converting a Word document to PDF with x86 target platform.
  • #237447 - Vertically merged cell border is now preserved properly while converting a Word document to PDF.
  • #237065 - Field text is now preserved properly while converting a Word document to PDF.
  • #234978 - Table is now preserved properly while converting a Word document to Image.
  • #231056 - Text is now aligned properly while converting a Word document to PDF.
  • #231056 - Symbol is now preserved properly while converting a Word document to PDF.
  • #231056 - Spacing issue has been resolved while converting a Word document to PDF.
  • #233059 - Paragraph is now preserved properly while converting a Word document to PDF.
  • #236740 - Hanging issue has been resolved while converting a Word document to PDF.
  • #236740 - Page is now preserved properly while converting a Word document to PDF.
  • #236740 - Hanging issue has been resolved while converting a Word document to PDF.
  • #231426 - Footnote content is now preserved properly while converting a Word document to PDF.
  • #229891 - Table is now aligned properly while converting an RTF document to PDF.
  • #221035 - Hanging issue has been resolved while converting a Word document to PDF.
  • #234243 - Text is now preserved properly while converting a Word document to PDF.
  • #236840 - Text color is now preserved properly while converting a Word document to PDF.
  • #237506, #240389 - Horizontally merged table cell border is now preserved properly while converting a Word document to PDF.
  • #236840 - Paragraph background color is now preserved properly while converting a Word document to PDF.
  • #233049 - Unicode text is now preserved properly while converting a Word document to PDF.
  • #F144521 - TraditionSansXLight font is now embedded properly while converting a Word document to PDF.

PDF

Features

  • #230886 – Added support for trailer ID in both new and existing PDF documents.
  • Added support for adding PDF annotation comments and reviews.
  • #225704 – Added support for creating PDF 2.0 documents.
  • #141255, #226165 – Added save progress support for an existing PDF document.
  • #235204 – Added PDF light table column width proportional sizing support.

Bug Fixes

  • #231273 - Free text and polygon annotation are now preserving properly while flattening the PDF document.
  • #231625 - Review status is now preserving properly while exporting or importing the annotations.
  • #231273 - Object null reference exception no longer occurs while flattening the PDF documents.
  • #231795, #231668, #231273, #233045 - Review status and layer are now preserving properly while importing annotations from the XFDF file.
  • #226015 - Grouped annotations are now preserving properly while importing or exporting the annotations.
  • #232559 - PDF form fields are now cloned properly.
  • #233194 – Text is now preserving properly while filling form fields.
  • #232477, #232754 - Application will no longer crash while importing pages from the PDF document.
  • #228012, #231381 - Form fields are now preserving properly when loading a PDF document in different instances.
  • #226230 - Form fields will never be missing while importing pages from a PDF document.
  • #232496 - File size will no longer increase while continuously saving a PDF document.
  • #233102 – Invalid cast exception will no longer occur while flattening the combo box fields.
  • #233004 – Form fields size is now preserving properly while flattening form fields.
  • #231901, #228043 - Annotations are now flattened properly in a PDF document.
  • #231965, #231964 - Now, you will get proper exception messages while creating the QR barcodes with incorrect values.
  • #230688 - Document will no longer corrupt while saving the encrypted PDF document.
  • #230023 - Output document will no longer corrupt while loading the PDF documents.
  • #228375 - Annotations are now preserved properly while flatting them.
  • #228486 - Key not found exception will no longer occur while loading PDF document.
  • #232754 - Exception will no longer occur while importing pages from existing PDF document.
  • #228202, #228667 - Output document will no longer corrupt while merging the PDF documents.
  • #228635, #226614 - Exception will no longer occurs while obtaining destination from annotation.
  • #231801 - Exception will no longer occur while opening 256-bit protected document in Nuance PDF.
  • #228341 - Code 128, code 32, and code 93 extended barcodes are now rendered properly.
  • #228336 - Null reference exception will no longer occur while merging the PDF documents.
  • #227845 - Acroform fields tab index is now retrieved properly.
  • #229922, #234322 – Color is now preserving properly while using PDF linear gradient brush with vertical mode.
  • #226451 - Font is now retrieved properly in the free text annotation.
  • #231299 - Null reference exception will no longer occur while saving a PDF document with Incremental update.
  • #142705 - QR barcode is now preserved properly while using special characters.
  • #237633 – Exception will no longer occur while signing PDF with timestamp server.
  • #237481 – Output document will never corrupt when open/save it using open and repair.
  • #237481 – Output document will never corrupt while changing the document permissions.
  • #236168 – Named destination will be added properly.
  • #234809, #144285, #235480, #237790 – Position is now proper while adding signature field to the existing PDF file.
  • #234458 – PdfLoadedPage client size is now retrieved properly.
  • #233768 – Layers are now preserved properly when flattening annotations.
  • #228341 – Code 93 and Code 93 extended barcode are not generated properly.
  • #235715 – Preservation issue will no longer occur while drawing PDF grid.
  • Combo box field values are now exported properly.
  • #234957 – Values are now preserved properly in MAC Preview, when filling or flattening form fields.
  • #239254, #238308 - Unexpected token object type exception will no longer occur while opening a PDF document.
  • #239073 - Key not found exception will no longer occur while accessing layer from a PDF document.
  • #238172 - Performance has been improved while loading and saving an encrypted PDF document.
  • Border is now preserving properly while creating the free text annotation.
  • #235462 - The resulted PDF file size is same while saving it multiple times.
  • #238699 - Invalid operation exception will no longer occur while loading the PDF documents.

Presentation

Features

  • #236376 - Support has been added to PowerPoint write protection.
  • #237068 - Support has been added to get the dynamic height of a PowerPoint table.

Bug Fixes

  • #212572, #229361 - The group-shapes will now be rendered properly if vertical or horizontal flips applied along with rotations.
  • #229361 - Table cell background is now properly applied for vertically merged cells in PowerPoint to PDF conversion.
  • #232725 - The NullReferenceException will no longer be thrown while converting PowerPoint to PDF.
  • #230386 - The StackOverflowException will no longer be thrown while accessing paragraph font color.
  • #230575 - Formatting will be preserved properly after cloning and merging a PowerPoint slide with destination theme.
  • #232687 - Chart axis and labels will now be rendered properly in PowerPoint to PDF conversion.
  • #233799 - The NullReferenceException will no longer be thrown while cloning OLE Object in master slide.
  • #231053 - Chart data label color will not be changed while cloning a PowerPoint slide with chart.
  • #233982 - The NullReferenceException will no longer be thrown while parsing customized master slide.
  • #236894 - Hanging issue has been resolved while parsing a PowerPoint with sound transition.
  • #236892 - The IndexOutOfRangeException will no longer be thrown while converting PowerPoint to Image.
  • #232687 - Value axis title will be aligned properly while converting PowerPoint to PDF.

SfAccordion

Features

  • Visual State Manager support has been provided to SfAccordion.

  • Data binding support has been provided to SfAccordion to bind a list of AccordionItem.

Breaking Changes

  • [Android] HeaderIcon has been aligned properly to center with some extra padding in SfAccordion control.

SfAutoComplete

Features

  • #232655 - SearchDelay support has been provided.
  • #234757 - [iOS] Tab key support has been provided.
  • #186723 - DataTemplateSelector support has been provided.
  • #235582 - [UWP] Support has been provided for preventing the text from being changed when pressing the down or up arrow key.
  • #221600 - SelectedIndex set access support has been provided.
  • #231439 - DropDownBorderColor support has been provided.

Bug Fixes

  • #237841 - [iOS] The ShowSuggestionOnFocus and IsSelectedVisibleInDropDown APIs now work properly.
  • #235744 - The SfAutoComplete now works properly inside SfTreeView ItemTemplate.
  • #238963- [UWP] While using key up/down to select data in suggestion list, scroll view will not be moving now. 

Breaking Changes

  • #235635 - TextSize and DropDownTextSize have been changed into double data type.
  • [UWP] Watermark behavior has been changed as per the default Entry control.

SfBadgeView

Bug fixes

  • # F144090 - [Android] The Java.Lang.LinkageError will no longer be thrown when setting the content to the badge view in Android version 4.4 devices.

SfButton

Features

  • #F144124 - Now, the button control supports gradient background.
  • #I236396 - The Accessibility support has been provided.
  • [UWP] Now, the button control supports MouseOver VisualState.

Bug fixes

  • #I238967 - [UWP] Now, the background color for SfButton has been applied properly to the disabled state.
  • #I228722 - [UWP] Now, the button click should not be passed to its parent view when the click event occurs.

SfCalendar

Features

  • #204121 – Support has been provided to change the number of weeks in Month view for SfCalendar.
  • #143348 - Decade view and Century view supports have been provided for SfCalendar.
  • #229940 - Support has been provided to customize the current day border color using the TodayBorderColor property of MonthViewSettings.

Bug Fixes

  • #239496 – [Android] The Binding Error will no longer occur when adding custom month cell in SfCalendar.
  • #238984 – [Android, iOS] Now, the InlineView event is updated properly at run time when InlineView of SfCalendar is open.
  • #240387 – [UWP] Now, the MonthChanged event occurs properly when setting the NavigateToMonthOnInActiveDatesSelection property in SfCalendar.
  • #239785 – [UWP] Now, the MonthCellLoadedEvent works properly when selecting a month cell date in SfCalendar
  • #239886 – [iOS] The Calendar YearView navigation works properly when tapping the month view header year text.

Breaking Changes

  • [Android, iOS] The default view mode of YearView has been changed to Month view. It can be modified using the YearViewMode property of SfCalendar.
  • Month header text color of YearView has been changed to Black.
  • [UWP] - Month date alignment has been changed to Center from Top.
  • [iOS] – In YearView, the line under the year label has been removed.
  • [Android] - Now, InlineView appointment height default value has been changed to 150.

SfChart

Features

  • Now, the chart control supports WPF platform in Xamarin.Forms.
  • The chart control supports to perform zooming based on pinch gesture direction.
  • Now, the chart control supports waterfall series type.
  • #I229122 - Now, the chart control supports to customize the appearance of individual axis element based on condition.
  • #I205947, I224398, I225317 - Now, the accumulation series fits with its desired size instead of expanded to available size of parent.
  • #F141502 – The chart supports to get the actual rendering color of series.
  • The GroupAllPoints support has been added to TrackballLabelDisplayMode enum.

Bug fixes

  • #I234728 – [Android] Now, the ZoomByRange method works properly for large values.
  • #I237785, I238310, I235595 - Now, the FontFamily and FontSize properties of chart axis title work properly.
  • #I237303 - Now, the SeriesContainsPoint method does not throw the exception when series contains huge data.
  • #I229730 - The ArgumentOutOfRangeException will no longer be thrown in FastLineSeries when series have single data point with tooltip.
  • #I239784 - [Android, iOS] Now, the NullReferenceException will no longer be thrown when add and remove the annotation at trackball invoke.

SfCheckBox

Features

  • The Accessibility support has been provided.
  • The Visual State Manager support has been provided to check box with Checked, Unchecked, and Intermediate states.

SfChip

Features

  • The Accessibility support has been provided.

SfCircularGauge

Bug fixes

  • # 232295 - [UWP] The StackOverflowException will no longer be thrown when the value of gradient stop is lesser than the end value of range.
  • # 232412, #143502 - [Android] Dragging pointer works properly for needle pointers and marker pointers.

SfComboBox

Features

  • #235635 - FontFamily support has been provided to Xamarin.Forms Standard.
  • #186723 - DataTemplateSelector support has been provided.
  • #221600 - SelectedIndex set access support has been provided.
  • #231439 - DropDownBorderColor support has been provided.
  • #232655 - SearchDelay support has been provided.

Bug Fixes

  • #236933 - [iOS] The SfCombobox is now rendered in a ListView ViewCell.
  • #235601 - [iOS] The SfComboBox text will not be changed when clicking the Done button in keyboard.

Breaking Changes

  • #235635 - TextSize and DropDownTextSize have been changed into double data type.
  • [UWP] Watermark behavior has been changed as per the default Entry control.

SfDataForm

Features

  • #144818 - TextInputLayout support has been provided to each DataFormItem in SfDataForm.
  • #207100, #139285, #215075, #216539, #142599 – Support has been provided to change the height of each DataFormItem in SfDataForm.
  • #204205, #142500 – Support has been provided to set the top or left LabelPosition for each DataFormItem in SfDataForm.

Breaking Changes

  • The Picker control has been removed and replaced with DataFormPicker in DataFormPickerEditor.
  • The DatePicker control has been removed and replaced with DataFormDatePicker in DataFormDateEditor.
  • The TimePicker control has been removed and replaced with DataFormTimePicker in DataFormTimeEditor.

SfDataGrid

Features

  • #142178, #164383, #164439, #F133551, #196244, #197627, #212312, #213385, #F126115, #214080, #214206, #F142365, #232564 - Support has been provided to group one or more column headers under a common stacked header row that spans across the DataGrid column headers.
  • #227127 - Support has been provided to a new ComboBox column type that hosts the SfComboBox control as its edit element.
  • #225740 - Support has been provided for auto-generating the columns for complex properties present in the underlying Entity Framework collection.
  • #222515, #F142116, #232982 - [UWP, MAC] Support has been provided for customizing the operations performed for key press actions of the keyboard using the ProcessKeyDown() override method in the GridSelectionController.
  • #231827, #233927 - Support has been provided to disable the diagonal scrolling to scroll the DataGrid vertically or horizontally based on panning.
  • #F143393 - [Android] Support has been provided to either span the editor for full screen or show the grid rows when a cell enters into the edit mode in landscape orientation.
  • #213211, #213874 - ItemsSource selector support has been provided to GridPickerColumn to set different ItemsSource to each row.
  • [UWP, MAC] Support has been provided to disable the deletion of row when the Delete key is pressed.

Bug Fixes

  • #219890 - [Android] Performance of the horizontal scrolling has been improved.
  • #237887 - Selection foreground color will be updated properly for the existing selected row even when ItemsSource is changed at run time.
  • #F137424 - XAML compilation error will no longer occur when the DisplayBinding property is set in XAML and the XamlCompilation.Compile tag is used.
  • #F144784 - The group expand/collapse icon will be displayed properly when a template content is loaded for the caption summary row and frozen column count is greater than 0.
  • #239231 - [UWP] Focus for the DataGrid will be obtained properly, and navigation will work properly for the key board key press actions even when multiple focusable controls are loaded in a page along with SfDataGrid.
  • #239225 - Value of unbound cells in the table summary row, group summary row, and caption summary row will be updated properly based on value changes to the unbound column at run time.
  • #F145422 - The NullReferenceException will no longer be thrown when GridTemplateColumn.CellTemplate is not set to a GridTemplateColumn.
  • #238520, #240331, #F145574 - Setting font attribute to the grid cell from the QueryCellStyle event handler works properly.
  • #F145435 - The GridColumn.HeaderCellTextSize works properly based on values in individual columns when scrolling horizontally.
  • #233335 - Rows are now re-arranged properly based on the sorting applied, when the cell value of a sorted column is modified when using SfDataPager.
  • #238814 - [UWP] The first and last numeric button no longer disappear when scrolling quickly and reaching the horizontal ends in SfDataPager.

SfExpander

Bug Fixes

  • #235758 - [Android] Application crash will no longer occur when SfExpander is loaded inside the Tabbed page.

Breaking Changes

  • [Android] HeaderIcon has been aligned properly to center with some extra padding in SfExpander control.

SfImageEditor

Bug fixes

  • # 231108 – The ToolbarSettings of SfImageEditor will no longer be reset when navigating between the pages.
  • # 229903 - [UWP] The offset and length were out of bounds exception will no longer be thrown when loading the image from file.
  • # F143025,I234600 – [UWP] The application will no longer be frozen when saving the image in release mode.

Features

  • Support has been provided to select the default drawing color from ColorPalette collection using the color index.

  • Support has been provided to smartly arrange the resize handle of Text and CustomView shape type when dragging the view outside the image editor bounds.

SfLinearGauge

Bug fixes

  • # 234821 The Scale and Pointer properties of LinearGauge will be updated when changing BindingContext dynamically.

  • # 236927 - The annotations of LinearGauge will not disappear when scrolling the ListView items with LinearGauge.

SfListView

Features

  • Support has been provided to display StickyFooter at the bottom of the last item in ListView when the items are lesser than body view size while setting the StickyFooterPosition to Body.

Bug Fixes

  • #144798, #237423, #237095 - [iOS] The button clicked event works properly on DoubleTap.

  • #239740 - The exception will no longer occur when SfListView loaded with template selector is added inside the SfPopupLayout.

  • #145038 - [Android] Swiping and the drag-and-drop operation work properly in SfListView when the ItemTemplate has gesture recognizer.

  • #239695 - [Android] Scrolling in SfListView works properly when it is loaded inside the ScrollView.

  • #237423, #226941 - [iOS] Touch process works properly when the SfSegmentedControl is loaded inside the SfListView.

Breaking Changes

  • #145038, #240008 - [Android] SfListView ItemTapped event will not fire hereafter while tapping the child element in ItemTemplate which has tap gestures whereas ItemTapped event will fire on tapping the child element which don’t have tap gestures.

  • The Header item will not consider top ItemSpacing and Footer item will not consider bottom ItemSpacing hereafter in SfListView control.

Known Issues

  • [Android] Application will crash when running in Release mode with SfListView control. This issue has been fixed in our 17.2.0.39 and later versions.

SfMaps

Bug fixes

  • # 229656 - The NullReferenceException will no longer be thrown when the value of ShapeIDPath is set to null.
  • # 230337 - [Android] Shape selection works properly after zooming.
  • # 229656 - [UWP] The ShapeSelectionChanged event occurs only one time when selecting a shape.
  • # 231962 – The GeoCoordinatesChanged event occurs when loading the maps and setting CacheTilesFiles to False.
  • # 235578 – The NullReferenceException will no longer be thrown when changing BindingContext dynamically.
  • # 232662 – The IndexOutOfRangeException will no longer be thrown when setting more than five properties in the model class.
  • # 232596 – The NullReferenceException will no longer be thrown when setting the Uri path from local folder with the folder structure count is greater than 10.
  • # 239175 – [UWP] The An item with the same key has already been added exception will no longer be thrown when binding the same marker collection to more than one SfMaps control.
  • # 234889 - ShapeFileLayer zoomed area will be positioned correctly when changing the device orientation.
  • # 239338 - [UWP] Map will be zoomed based on the ZoomLevel value even when setting the EnableZooming to false.

Features

  • Support has been provided to change the Marker’s IconColor and Data label color smartly based on the background color.
  • Support has been provided to add the polylines and points shapes to maps.

SfMaskedEdit

Bug fixes

  • # 231390 – The Value of MaskedEdit will be updated properly when pasting the text from clipboard.
  • # 231962 - [UWP] The deleted text will not be displayed when entering new text.
  • # 233970 - The capitalization keyboard will be shown when entering the text if the KeyboardFlags of SfMaskedEdit is set to CapitalizeCharacter.
  • # 233278 – The ArgumentOutOfRangeException will no longer be thrown when setting the minimum length to zero in Mask.
  • # F144241 – The PromptChar characters will be hidden when loading the SfMaskedEdit.
  • #230013 – The old content will be removed when adding the MaskedEdit control to TableView.
  • # 237034 - Mask will be updated when setting the MaskType to RegEx and changing the Value dynamically.
  • # 239094 – The ArgumentException will no longer be thrown when entering the text after the last character of the text.

SfNavigationDrawer

Features

  • #230577 - The ContentBackgroundColor API support has been provided to NavigationDrawer.

Bug Fixes

SfPdfViewer

Features

  • #191469, #223014, #224738, #225436 #226356, #228236, #230351 – Support for custom stamp annotation has been provided.
  • #196290, #200911, #211119, #233085 – Optimized the huge time taken while searching text in larger PDF document.
  • #233085 – Support to display loading indicator and the highlighted text instance count out of total occurrences while searching the text has been provided.
  • #226544 – Localization support for ScrollHead has been provided.
  • #226922 – Accessibility support for SfPdfViewer has been provided.
  • #232733 – [Android, iOS] Editing support has been provided for combo box form fields.

Bug Fixes

  • #230299 – Now, the PDF document will be loaded properly when it is loaded inside the OnAppearing method block.
  • #232883 – Now, radio button with same form field groups can be selected properly.
  • #232731 - Scroller will no longer move to first page while entering input in the text box field presented in other pages.
  • #232733 - First item of combo box will not be selected or shown if the loaded document does not contain selection index.
  • #232833, #230868 - Application will no longer crash when loading the PDF document.
  • #232737 - Now, the form field values will be preserved properly when saving a PDF document.
  • #233304 - [Android] Null Reference Exception will no longer occur and the application will not get crashed while unloading particular PDF document.
  • #232829 - [iOS] Signature field will be visible when loading the particular PDF document.
  • #232829 - [Android] Application will no longer crash when loading the particular PDF document.
  • #231180 - [Android, iOS] Radio buttons and check boxes will be displayed properly in the particular PDF document.
  • #234246 – [UWP] DocumentLoaded event will not be raised when resizing the application window.
  • #233757 – Null Reference Exception will no longer occur while loading a particular PDF document.
  • #231299 - Application will no longer crash by throwing NullReferenceException while saving the PDF document which contains form fields.
  • #228010, #230801 – [Android] Buttons in the signature will not be cropped irrespective of device text size.
  • #229152 – Now, search bar will be fit to the width of the SfPdfViewer.
  • #227860, #228012 – Form fields in the saved document using the SfPdfViewer will be displayed properly in Adobe reader.
  • #228012 – Now, form fields are editable while loading the specific PDF document.
  • #227492 - UnhandledException will no longer occur on navigation to the MasterDetail page which contains SfPdfViewer.
  • #226758 – Exception will not be thrown while unloading the SfPdfViewer.
  • #F142467 – [iOS] Exception will no longer occur while performing ClearAllAnnotation.
  • #F143933 – Existing ink annotation associated with the PDF document will be displayed and saved properly.
  • #F143778 – ObjectDisposedException will no longer occur while unloading the SfPdfViewer which is placed inside SfNavigationDrawer.
  • #F142673 – [Android] IllegalStateException will no longer occur after adding FreeText annotation.
  • #235888, #236654 – Ink annotation is now preserved properly when saving the PDF document.
  • #234953 – [iOS] Signature pad’s screen orientation is now properly preserved.
  • #234459 – Text present in the text box form field is now displayed properly.
  • #232496 – Stream length is now preserved properly after saving the PDF document.
  • #193765 – [UWP] Application will no longer crash when loading the PDF document in OnAppearing method.
  • #236351, #238736 – Forms fields are now preserved properly after removing first page in the PDF document.
  • #236495 – Page navigation is now working properly after setting the PageNumber property.
  • #236713 – Zooming is now working properly with respect to the device orientation.
  • #236652 – The position of signature is now preserved properly in the PDF document.
  • #235803 – Signature field’s rotation is now preserved properly.
  • #236640 – Ink annotation is now preserved properly when saving the PDF document.
  • #237028 – Undo operation on signature is now working properly.
  • #237125 – Magnification of PDF documents is now working properly with different screen orientations.
  • #236713 – [iOS] Application will no longer crash when magnifying the PDF document.
  • #236713 – [iOS] Magnification of the particular PDF document is now working properly.
  • #233304 - [Android] ObjectDisposedException will no longer occur on unloading the SfPdfViewer.
  • #237326 - [Android] PDF document will be displayed properly on setting the ZoomPercentage.
  • #237119 - [Android] Application will no longer be crashed while scrolling the PDF document.
  • #237119 – [Android] Application will no longer be crashed while loading the specific PDF document.
  • #240794 – [iOS]Custom stamp annotation will be saved properly when it is in the selected state.
  • #239647, #238470 – FindText returns true while identifying the text on devices in which the default language is set to Czech, Spanish, and German.
  • #241027 – Application will no longer be crashed on setting the visibility of the built-in toolbar items.
  • #237846, #236956 – Now, Large size PDF documents are loaded faster.
  • #236649 – [Android] Application will no longer be crashed by throwing the NullReferenceException while saving the particular PDF document.
  • #237265 – Now, ExtractText extracts the text properly from the PDF document.
  • [UWP] Application will no longer be crashed on performing search operations.
  • [UWP] Horizontal scrollbar will be completely visible inside SfPdfViewer.
  • [UWP] Collection modified exception will no longer occur on loading the PDF document.
  • [iOS] Application will no longer crash when setting the AnnotationMode to HandWritten.
  • InvalidOperationException will no longer occur in SfPdfViewer.
  • Application will no longer crash when clicking the hyperlinks.

SfPicker

Features

  • Support has been provided for DataTemplateSelector in SfPicker.

Bug Fixes

  • #236621, #236972 - [Android, iOS] Now, SfPicker works properly using custom month logic.
  • #237872 - [iOS] Now, SfPicker works properly with the EnableLooping API.
  • #235765 - [iOS] Now, the columns do not overlap when the visibility of SfPicker is changed.

SfPopupLayout

Features

  • #231809, #230988, #237269 - Support has been provided to auto-size the content loaded inside the PopupView.ContentTemplate in either width, height, or both.
  • #232365 - [Android] Support has been provided to keep the Popup open even when the back navigation key is pressed.
  • #228477 - Support has been provided to customize the background color and opacity and to always show the overlay even when setting the width and height of a Popup.

Bug Fixes

  • #237384 - The NullReferenceException will no longer be thrown when switching between tabs of a shell layout in Xamarin.Forms 4.0.
  • #237222 - [iOS] Popup will consider the bottom safe area in iPhone X when displaying its contents.
  • #237889, #239863 - [iOS] Application will not be crashed in iOS devices, running version 9.0 and downwards, when setting corner radius for Popup view.
  • #F141648, #226475, #F142125, #238092, #F145338 - [Android] The overlay background behind the Popup view spans for the full width and height of the screen in all orientations even in devices that support to hide or show the soft navigation bar at run time.
  • #240398 - [UWP] The overlay background behind the Popup view spans for the full width and height of the screen when SfPopupLayout.IsFullScreen is set to true and the Popup is opened for the first time inside a navigation page.

SfPullToRefresh

Bug Fixes

  • #238245 - [UWP] Application will not be crashed when the refreshing action is performed programmatically when navigating to a new page.
  • ##238436 - The progress circle is rendered properly when performing the pull-to-refresh action after navigating to a new page.
  • #237737 - The pull-to-refresh action works properly when triggering manually even after the refreshing action is programmatically triggered from the Page.OnAppearing() override.

SfRadialMenu

Features

  • #216121 - Support has been provided to set the start angle of the radial menu item.

Bug Fixes

  • #238209 - Now, the SfRadialMenu can be dragged using the custom view.

SfRadioButton

Features

  • #I208956 – Now, the GroupKey support has been provided to SfRadioButton.
  • #I210316 – Now, the radio group provides support to get the current CheckedItem.
  • #F138715 – Now, the CheckedChanged event is exposed in radio group to get previous and current checked items.
  • The Accessibility support has been provided.
  • The Visual State Manager support has been provided to radio button with Checked and Unchecked states.

Bug fixes

  • #I236963 - Now, the SfRadioButton is resized properly when dynamically changing its text.

SfRangeSlider

Features

  • #216544 - Support has been provided to customize the touch behavior using ValueChangeMode.
  • The TouchUp and TouchDown events have been implemented.

SfRating

Features

  • Support has been provided to select a range of values when using custom views.

SfRotator

Features

  • Support has been provided for DataTemplateSelector in SfRotator.
  • The performance of SfRotator has been improved in this release.
  • The ItemTapped event and Command support have been provided for performing an action when tapping the items.

Bug Fixes

  • #238165 - Now, the SfRotator works properly when loading the items asynchronously.

SfSchedule

Features

  • #150133, #154111, #188784, #198541, #220657, #222172, #223609, #235542, #236744 – TimelineView support has been provided for SfSchedule.
  • #161982, #170888, #175092, #181178, #131766, #194090, #194166, #198541, #137414, #137495, #223530, #223609, #236744 – Resource support has been provided for all ScheduleView in SfSchedule.

Bug Fixes

  • #235682 – [UWP] Now, the CellTapped event of SfSchedule returns the selected date properly when tapping span appointment in month cell.

SfSegmentedControl

Bug Fixes

  • #I233599 - [iOS] Now, Scrolling will not be enabled if the segmented items fit with their control’s width.

SfSwitch Preview

The Switch control allows you to turn an item on and off, and provides an optional indeterminate state. It supports VSM, busy state, and gradient colors.

Key Features

  • Visual types: Supports built-in visual types such as Material, Cupertino, and Fluent.
  • Indeterminate state: Supports an additional state called indeterminate state.
  • Visual State Manager: Support to customize the switch’s thumb and track based on switch states.
  • Orientation: Supports vertical orientation.
  • Gradient: Support to customize its background with gradients.
  • RTL support: Supports right-to-left(RTL) direction.

SfTabView

Features

  • Support has been provided to set the transition delay for tab navigation.
  • #232992- Image and FontIcon supports have been provided for drop-down items in the OverflowMode.

Bug Fixes

  • #237450 – Now, the SfTabView is rendered as empty without crashing when content is set to null.
  • #235609 - [UWP] Now, scrolling works without conflicting the scroll behavior of SfTabView properly.
  • #236890 - [Android] Now, the SelectedIndex is updated properly when removing the items of drop-down in the OverflowMode.

SfTreeMap

Features

  • Support has been provided to drilldown the TreeMap.

SfTreeView

Features

  • Support has been provided to adjust the height of TreeViewNode dynamically based on its content with the QueryNodeSize event in TreeView.

  • Support has been provided to scroll programmatically based on the ScrollToPosition in TreeViewNode.

  • Support has been provided to expand LoadOnDemand programmatically.

Bug Fixes

  • #235318 - The NullReferenceException will no longer occur when the SfTreeView is loaded into the MasterDetail page at runtime.

  • #234595 - Now, the collapsed child node is brought into view when the additional parameter CanExpand is passed to true in the BringIntoView method.

Known Issues

  • SfTreeView will crash during its dispose. This issue has been fixed in our 17.2.0.35 and later versions.

XlsIO

Features

  • #227983 - Exception, “Text length cannot be more than 32767” can be ignored using the ExcludeAdditionalCharacters property.
  • #230550, #230543 - Excel table with query parameters is implemented.
  • #222226 - DropLines in Excel charts are now supported.
  • #F143384 - Support to get direct dependents and direct precedents of a cell is provided.

Breaking Changes

  • #227983 - ExcludeAdditionalCharacters has been added in IApplication class to ignore exception and exclude characters more than 32767 (maximum allowed characters) in a cell text.
  • #230550, #230543 - IParameters interface is added to represent the parameter collection of query table.
  • #230550, #230543 - Add() method is added in IParameters interface to add parameter to the query table.
  • #230550, #230543 - ExcelParameterDataType enum is added to represent the parameter data types.
  • #230550, #230543 - ExcelParameterType enum is added to represent the parameter types.
  • #230550, #230543 - IParameter interface is added to represent the parameter of query table.
  • #230550, #230543 - DataType property is added in IParameter interface to represent the SQL data type.
  • #230550, #230543 - Type property is added in IParameter interface to represent the parameter type.
  • #230550, #230543 - PromptString property is added in IParameter interface to represent the prompt string.
  • #230550, #230543 - Value property is added in IParameter interface to represent the parameter value.
  • #230550, #230543 - CellReference property is added in IParameter interface to represent the parameter cell reference.
  • #230550, #230543 - Name property is added in IParameter interface to represent the parameter name.
  • #230550, #230543 - RefreshOnChange property is added in IParameter interface to indicate whether the query table will be refreshed when the parameter is changed.
  • #230550, #230543 - Prompt property is added in IParameter interface that occurs when refreshing the table after setting the parameter type to prompt.
  • #230550, #230543 - SetParam() method is added in IParameter interface to set value to the parameter.
  • #230550, #230543 - Parameters property is added in QueryTableImpl class to represent the parameters of query table.
  • #234003 - IgnoreSheetNameException property is added in both IApplication interface and ApplicationImpl class, which gets or sets a boolean value to ignore duplicate worksheet name exception by adding a suffix at the end.
  • #222226 - HighLowLines property in IChartFormat class gets high-low lines of stock and line charts.
  • #222226 - DropLines property in IChartFormat class gets drop lines of stock, line and area charts.
  • #222226 - DropLineStyle property in IChartFormat class gets or sets drop lines or high-low lines or series lines.
  • #222226 - HasDropLines property in IChartFormat class gets or sets a boolean value denoting the drop lines of stock, line, or area charts.
  • #222226 - HasHighLowLines property in IChartFormat class gets or sets a boolean value denoting the high-low lines of stock or line charts.
  • #222226 - HasSeriesLines property in IChartFormat class gets or sets a boolean value denoting the series lines of pie of pie or bar of pie charts.
  • #F143384 - GetDirectPrecedents() method is implemented in IRange class to get the direct precedent cells, which are referred by a formula in another cell.
  • #F143384 - GetDirectDependents() method is implemented in IRange class to get the direct dependent cells, which refer to other cells.

Bug Fixes

  • #F144022, #224520 - Conditional formatting formula with sheet reference is now proper.
  • #227766, #231068 - Chart legend is now rendered properly while changing the chart type.
  • #232040, #232682 - Cell background color is now rendered properly on converting XML to XLSX format.
  • #229121 - Picture name is now updated properly after removing a picture and inserting a new picture.
  • #226753 - Exception is no longer thrown while opening an Excel file with formula in Dutch culture.
  • #230294 - Picture created with camera tool is now properly changed with the INDIRECT() formula.
  • #230697 - After accessing the used range, relative range indexer is now working properly.
  • #231469 - Application no longer hangs while opening an Excel file with picture that has unsupported elements.
  • #226860 - Performance will not degrade on exporting a range to a data table multiple times.
  • #229117 - Named range index is now updated properly while copying ranges from two different workbooks.
  • #228853 - Footer value in source worksheet no longer changes while modifying footer in cloned worksheet.
  • #228560 - Null reference exception is no longer thrown while cloning the workbook.
  • #224793 - Extra pages are no longer added with FitAllColumnsOnOnePage layout setting in Excel to PDF conversion.
  • #231271 - Timestamp is preserved in zip file.
  • #227209 - Argument out of range exception is no longer thrown while applying the template marker with UnKnownVariableAction.ReplaceBlank.
  • #232727 - Argument exception is no longer thrown while opening an Excel file with IgnoreErrors.
  • #228711 - Performance will not degrade on exporting data from Grid to Excel.
  • #226133 - ArgumentOutOfRangeException is no longer thrown while accessing a range from cloned workbook.
  • #225831 - NullReferenceException is no longer thrown while converting worksheet to PDF.
  • #229460 - Exception is no longer thrown while converting Excel to PDF with hyperlink.
  • #231882 - Performance will not degrade on exporting pivot grid to Excel.
  • #232040 - Cell Styles are now preserved properly after resaving the output file with Microsoft Excel.
  • #232473 - Macro name is now set properly in shapes.
  • #227998 - Pivot table with tabular layout no longer increases the page count in Excel to PDF conversion.
  • #230759 - Conditional formatting with discontinuous range is now preserved properly in Excel to PDF conversion.
  • #229528 - Exception is no longer thrown while opening a resaved Excel document with ExcelIgnoreError option.
  • #227410 - Pivot table field item is now preserved properly while resaving the Excel file with the IsRefreshOnLoad property.
  • #235570 - Exception is no longer thrown when setting date time value in general format without having date separators.
  • #233740 - Exception is no longer thrown on converting Excel to PDF with Doughnut chart.
  • #228415 - Ole object formula bar is now shown properly on resaving the Excel document with Ole object.
  • #236136 - Exception is no longer thrown while setting PivotFieldDataFormat as PercentageOfParent in pivot table.
  • #225098 - The position of form controls (CheckBox, ComboBox, OptionButton) is now updated properly on inserting row or column.
  • #234572 - Data validation is now properly preserved while resaving the Excel document.
  • #234003 - Exception is no longer thrown while setting existing name to the worksheet.
  • #225207 - Series missing issue with incompatible charts is fixed.
  • #233740 - Issue with “Textbox in chart is missing while resaving the Excel document” has been fixed.
  • #236712 - Performance is improved while saving Excel file in .NET Standard.
  • #235011 - Exception is no longer thrown while opening the Excel document with negative anchor row and column.
  • #199992 - Chart Axis interval is now preserved properly in chart to image conversion.
  • #234789 - Multiple filter is now working properly in pivot table while setting IsMultiFieldFilter to TRUE.
  • #234003 - Exception is no longer thrown while setting a name that is already in the existing sheet names collection.
  • #222226 - HighLowLines and DropLineStyle APIs have been exposed.
  • #231382 - Spreadsheet XML is now stable.
  • #231382 - Named range is now stable.
  • #238059 - Time format is now properly preserved while setting date time values.
  • #F141716 - Exception is no longer thrown while opening the Excel file when a namespace is not defined.
  • #F142864 - Exception is no longer thrown while accessing the IRange.Value property in multi-threading.
  • #F143467 - Argument null exception is no longer thrown while converting Excel to PDF.
  • Issue with “Waterfall chart individual data label color is not changing” has been fixed.