Essential Studio for Xamarin.Forms Release Notes
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.
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 thePdfPen
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
andSelectionChanged
events will be raised while deselect dates whenToggleDaySelection
is set as true (UWP). - #223789 –
BlackOutColor
will be applied properly on the current view ofSfCalendar
(UWP). - #222298 - Custom
InlineView
will be rendered properly inSfCalendar
(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 theToggleSeriesVisibility
is false in theChartLegend
. -
#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 theItemsSource
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 toEnd
.
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 theSelectedItem
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 settingBackgroundColor
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
withScrollingMode
asPixelLine
. - #224519: The NullReference exception is no longer thrown when navigating from one page to another and
ItemsSource
is set in theOnAppearing
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 totrue
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 theAddShape
method. -
#223574 -
Rectangle
shape will no longer exceed the boundary of theSfImageEditor
.
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 theSelectAll
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, andScrollToRowIndex
is applied to the loaded event.
SfMaps
Bug fixes
- # 222606, #141389 –
MarkerTemplate
binding will be worked, when changing theMarkerTemplate
dynamically. - # 141437, #222839 – The
KeyNotFoundException
will no longer thrown while changing theMarker
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 inSfPdfViewer
. - #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
inMVVM Cross
above version 6, initialize the renderer code Xamarin.Forms.Android renderer like theSfPopupLayoutRenderer.Init(this)
. - # Default background color for
PopView
is now changed fromTransparent
toWhite
.
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
inSfSchedule
(Android and iOS). - #223491, #224875 –
RecurrenceCount
andWeekDays
values ofRecurrenceProperties
will return the correct value inSfSchedule
. - #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.) inSfSchedule
.
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
asDisplayMode
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 insideFlexLayout
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 inXlsIORendererSettings
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.