Essential Studio for Xamarin.Forms Release Notes
Common
Breaking Changes
In our previous releases, following permissions have been enabled in some of our controls by default. Now, these permissions have been removed from our assemblies as it is intended to be added in your application as needed.
[assembly: UsesPermission(Android.Manifest.Permission.Internet)]
[assembly: UsesPermission(Android.Manifest.Permission.WriteExternalStorage)]
Hence, you need to add Android.Manifest.Permission.WriteExternalStorage permission explicitly in your application, if you have used following features in our controls.
- SfDataGrid - Exporting to Excel and PDF feature needs WriteExternalStorage permission to save the file.
- SfChart - SaveAsImage feature needs WriteExternalStorage permission to save the image.
- SfImageEditor - needs WriteExternalStorage permission to save the edited image.
DocIO
Breaking Changes
-
WordDocument.Background.Type
property will not return the valueNoBackground
, if show background in print layout view option is disabled and valid background is defined. In this case make use of new propertyWordDocument.Settings.DisplayBackgrounds
to check whether show background in print layout view option is enabled or disabled.
Bug Fixes
- #184513 - Formula fields are updated properly while calling UpdateDocumentFields() method.
- #183656 -
NullReferenceException
will no longer thrown while closing a particular Word document. - #183819 -
NullReferenceException
will no longer thrown while setting WMergeField.FieldName property. - #184348 -
NullReferenceException
will no longer thrown while parsing Word document which contains shapes. - #183627 - Document background color is preserved properly while resaving a particular Word document.
- #182050 - Page orientation will be preserved properly while resaving a particular Word document.
Bug Fixes
- #185884 - Empty page is not created, when merging particular PDF document.
- #185722 - PDF document with Adobe flash is now merging properly.
- #182001 - Form fields are not duplicated, when load and save the PDF document.
- #185460 - Attachment collection is not empty, when loading a particular PDF document.
- #185098 - Exception no longer occurs when merging particular PDF document.
- #184712 - The document keywords are not duplicated when using commas along with keyword.
- #184488 - Null reference exception no longer occurs when signing existing PDF document.
- #183595 -
ArgumentOutOfRange
exception is no longer occurs when importing pages from a particular PDF document. - #182438 - Named destinations are now preserving properly, when adding to the existing PDF document.
- #182417 - Annotation are now removing properly from
PdfLoadedPage
. - Signature fields are not duplicating when loading and saving the signed PDF.
- Form fields are not empty when loading and saving the PDF document.
-
PopUp
annotation is preserving properly after flattening.
Presentation
Bug Fixes
- #184967 -
ArgumentOutOfRangeException
will not be thrown while cloning a PowerPoint slide with pie chart. - #182963 -
FontSize
property ofFont
class will now return the correct value. - #185237 - The shape name will be preserved like Microsoft PowerPoint, while creating new slide from an existing layout slide.
- #185236 - The shapes in the footer will be preserved properly while creating new slide from an existing layout slide.
SfAutoComplete
Bug Fixes
- #184440 -
ClearValue
method will clear theSelectedValue
in SfAutoComplete. - #182955 -
SfAutoComplete
works correctly when entering the random online data. - #183103,#184383,#184227- Entering the text dynamically will be shown in SfAutoComplete.
SfCalendar
Bug Fixes
- #181959 - Swiping of SfCalendar has been worked fine after setting Today’s date as
SelectedDate
andMoveToDate
. - #184266 - Empty view issue with
YearView
mode has been resolved in Android. - #131793 - Now,
StackOverFlow
exception is no longer thrown while rotating the calendar control on Android version 4.2.
SfChart
Bug Fixes
-
#185509 - Now, the axes labels will render properly even after zooming when Minimum and Maximum properties are set explicitly.
-
#185450 - Now, the data marker will render properly in
PieSeries
while using smart labels. -
#185696 – Issue with truncating percentage in data marker label has been fixed in
PieSeries
. -
#185542 - Now, the data marker labels for
RangeColumnSeries
will render properly. -
#185660 - The issue with
ChartAxis
ticks position has been fixed. -
#184523 – Now, the exception “Can’t access disposed object” will no longer be thrown.
-
#185571, #185619 – Now, the
ChartSeries.IsVisible
property will change dynamically when the series visibility is changed usingChartLegend
. -
#186152, #183740-
StackingColumnSeries
will no longer throw System.InvalidCastException.
Improvements
- #184837, #184921 - Improved the
ScatterSeries
performance while zooming and panning.
SfCircularGauge
Bug Fixes
-
# 184907 - Now minor ticks will render properly with default value for offset.
-
# 185851 - Now circular gauge will not throw null exception when it is used inside the relative layout in Xamarin.Forms iOS.
-
# 185061 - Now range pointer will render properly with default value for offset.
-
# 183743 - Now circular gauge will render properly in release mode with Linking option enabled.
SfDataGrid
Bug fixes
- #178946, 179865, 181576 - Pull-to-refresh action is now smooth in both touch and mouse for Xamarin.Forms.UWP.
- #185872 - Edit element border is now not shown when editing the
GridTextColumn
with padding as 2. - #185448 - SfDataGrid now does not retain the old selection when setting
SelectedItem
asnull
. - #185180, F131966 - Application now does not crash when changing the ItemsSource after updating
SfDataGrid.GroupColumnDescriptions
. - #184737 -
CultureInfo
is now applied for the GridColumns based onGridColumn.CultureInfo
property. - #182119 - Application now does not crash while adding SfDataGrid in runtime with
HeaderRowHeight
as0
. - #184285 -
SfDataGrid.EditorSelectionBehavior
withSelectAll
is now working properly in Xamarin.Forms.iOS platform. - #178946, 182809 - Refresh spinner now automatically hides when
SfDataGrid.IsBusy
is false in Xamarin.Forms.iOS. - 184747 - Record style is now applied when exporting to excel.
- 184331 - Selection and Editing now works properly with custom
GridCell
. - 183032 -
SfDataGrid.ScrollToColumnIndex
is now working in consideration withRowHeader
and frozen columns.
Enhancements
- #185137 - Support for programmatically updating the updating the
GridUnboundColumn
has been provided. - #180308 - Loading and scrolling performance for
GridTemplateColumn
has been improved. - #F130876 -
NewValue
andOldValue
of the edited cell has been provided in theGridCurrentCellEndEditEventArgs
.
Breaking Changes
- The below APIs are marked as obsolete and alternate APIs has been provided. Refer the below table for the obsolete APIs and new APIs.
S.No. | APIs marked as Obsolete | New APIs |
---|---|---|
1 | SfDataGridTheme.GetBordercolor | SfDataGridTheme.GetBorderColor |
2 | SfDataGridTheme.GetCaptionSummaryRowForeGroundColor | SfDataGridTheme.GetCaptionSummaryRowForegroundColor |
SfDateTimeRangeNavigator
Bug Fixes
SfDigitalGauge
Bug Fixes
- #183743 - Now digital gauge will render properly in release mode with Linking option enabled.
SfImageEditor
Bug Fixes
- # I85256 - Now image will be saved with its actual size in Image Editor Android.
SfLinearGauge
Bug Fixes
- #183743 - Now linear gauge will render properly in release mode with Linking option enabled.
SfListView
Bug Fixes
- #184592 - Tab navigation now working properly on swiping action when horizontal list view is loaded in
TabbedPage
. - #185683 - List view items are now layout properly when device orientation is changed after scrolled to end.
SfNavigationDrawer
Bug Fixes
- #184874-
DrawerContentView
displayed correctly for the first time.
SfNumericTextBox
Bug Fixes
- #185905 -
SfNumericTextBox
will consistently get updated when using DataBinding. - #185823 - Now,
MaximumNumberDecimalDigit
is working fine. - #185309 - Now, binding on
Value
property works correctly.
Features
- Support to provide
Return key
in SfNumericTextBox.
SfNumericUpDown
Bug Fixes
- #132035 - Now, binding works correctly.
- #179787,#185566-
SpinButton
performs the increment and decrement operations correctly.
Features
- Support to provide
Return key
in SfNumericTextBox.
SfPdfViewer
Bug Fixes
- #183743 -
SfPdfViewer
control will no longer throw exception while deploying the application whenLinker behavior
option is set toLink all assemblies
.
SfPicker
Bug Fixes
- #185068 - Now, SelectionChanged event fired at initial in iOS.
- #185068 - Binding issue with
SelectedItem
property has been resolved in Android.
SfPullToRefresh
Bug fixes
- #179676 - Application no longer crashes while customizing the
SfPullToRefresh
control.
Breaking changes
-
SfPullToRefresh.PullingThershold
is marked as obsolete. Use the new propertySfPullToRefresh.PullingThreshold
for the same purpose.
SfRotator
Bug Fixes
- #183451 - Now, Rotator’s first image has been rendered properly in UWP.
SfSchedule
Bug Fixes
- #185904 - Now,
MonthViewCellStyle
properties are working properly in Xamarin.Forms(Android). - #185414 - Now, Appointments in the view are cleared properly when clear the
ScheduleAppointmentCollection
in Xamarin.Forms(Android and iOS). - #185409 - Now,
VisibleDatesChanged
event will be triggered properly when change theScheduleView
dynamically in Xamarin.Forms(Android). - #185425 - Now,
VisibleDatesChanged
event will be triggered properly when navigate to a specific date in Xamarin.Forms(Android). - #185590 - Now, Appointment indicators in month view are displayed properly in Lollipop version also in Xamarin.Forms(Android).
- #180334,#175935 - Now, Appointments will be intersected properly when multiple appointments are sharing the same time periods in day, week and work week views.
Features
- Spanning of appointment will be displayed in separate panel when an appointment start and end in different dates.
- Current date and day color can be customized in view header of the schedule(day, week and work week views).
SfSparkline
Bug Fixes
- #186142 –
EmptyPointValue
will work properly in Android and iOS platforms while giving Double.NaN for data point values.
XlsIO
Breaking changes
- #185530, 185561 - Exposed an API
Name
to get OLE object name inIOleObject
class.
Bug fixes
- #182915 - Issue with borders being cleared while merging cells is fixed.
- #183016 - Issue with cell text casing while setting number format is fixed.
- #183332 - Issue with conditional format is not preserved which has formula as another worksheet range, is fixed.
- #183361 - Marker color gets changed on resave is fixed.
- #183369 - Exception is no longer thrown on assigning the scatter chart category axis properties.
- #183445 - Exception is no longer thrown while inserting rows in XLS format file.
- #183738 - Performance issue while opening Excel file with multiple charts is fixed.
- #183799 - Issue while setting print title rows for binary files is fixed.
- #183807 -
CopyTo()
method is not working properly after applying AutoFilters is fixed. - #184328 - Exception is no longer thrown while applying data validation through
ListOfValues
property. - #184407 - Index out of range exception is thrown while setting RTF text is resolved.
- #184407 - Key not found exception is thrown while setting RTF text is resolved.
- #184540 - Binary Excel file gets corrupted while copying range with conditional formats is fixed.
- #184569 - Cell value with comma character is changed while saving in CSV format is fixed.
- #184894 - Exception is no longer thrown while adding
IconSet
multiple times. - #185139 - Argument exception is no longer thrown while coping worksheet with EMF images.
- #185527 - Application hanging issue while opening the Excel file with table is resolved.
- #184160 - Issue with incorrect margin values on resave is fixed.
- Sorting (descending order) is not working properly when filtering a column is fixed.
- Issue with copy and paste of formatted cells is fixed.
- Issue with
IsBestFit
property while accessing theSetColumnWithPixes
method is fixed. - Stack overflow exception is no longer thrown while accessing
RefersToRange
property. - Argument exception is no longer thrown while copying one range to another range with styles.
- Argument exception is no longer thrown when sorting filtered numbers in descending order.
- The old and new cell values are validated on copy/paste through
ValueChanged
event. - AutoFit is now proper when text in the input file contains line feed and wrap text is set to false.
- Performance issue in filtering when sheet has comments is fixed.
- Exception is no longer thrown when coping the defined names between different workbooks.
- Exception is no longer throw when cloning shape during
AddCopy()
method. - Exception is no longer thrown while accessing table range using formula token.
- Calculated column formula is not updated during
AddCopy()
is fixed. - Null reference exception is no longer thrown while serializing conditional formats during
AddCopy()
. - Issue with
ColorRGB
inBorders
is fixed.