Version

Breaking Changes in 2017 Volume 2

Breaking Changes Summary

The following table summarizes the breaking changes of the Ultimate UI for WPF 2017 Volume 2 Release. Detailed explanations of the issues are provided after the summary table.

xamDataChart

Change to WindowResponse Default Value

Changed the default value of WindowResponse from Deferred to Immediate. This means that panning and zooming actions will happen immediately as the user moves the pointer position during these actions. The previous Deferred behavior would wait until the user finished the movement before refreshing the view.

xamDataPresenter

UI Automation Peers Are Virtualized

The cell UI automation peers are now virtualized. This means that you can obtain a peer only for hydrated cells, which may cause some automated tests (that rely on UI automation) to fail. If you need to switch back to the old behavior you should set the static DataPresenterBaseAutomationPeer.ProcessCellsInViewOnly property to false.

GlyphRun Used Instead of FormattedText in SimpleTextBlock

The SimpleTextBlock which is found in the editor templates found in cell templates now uses GlyphRun instead of FormattedText to display the cell text. This leads to significant performance improvements when rendering the cells but some advanced features like ligatures are not supported. If you need the old behavior you should set the inherited attached SimpleTextBlock.GlyphRunMode property to Never on either the data presenter control or any of its ancestor elements. Note that the GlyphRunMode enumeration also provides other options for selectively using GlyphRun or FormattedText based on the text being displayed.

xamDoughnutChart

Changed IsSurfaceInteractionDisabled property type

Originally, IsSurfaceInteractionDisabled was a nullable boolean but this has been changed to a generic boolean (bool? → bool). This keeps in line with the xamPieChart’s IsSurfaceInteractionDisabled property. The property will still function the same in that if you set the property on a RingSeries it will take precedent over the one set on the xamDoughnutChart.

xamGauge

xamGauge Controls Removed

Starting with the release of 2017 Volume 2, the InfragisticsWPF.Controls.Charts.XamGauge assembly will no longer be available. This effectively removes the following controls:

  • xamLinearGauge

  • xamRadialGauge

  • xamSegmentedDisplay

Note
Note

The xamLinearGauge and xamRadialGauge controls mentioned above are the ones that existed as part of the xamGauge family of controls. The InfragisticsWPF.Controls.Gauges assembly that contains the newer version of these gauges still exists in 2017 Volume 2. You can read further about the newer version of these gauges by viewing the documentation for the xamLinearGauge and xamRadialGauge.

xamGeographicMap/xamMap

Removed Classes

The XamGeographicMap and XamMap controls used CloudMade imagery and tile sources. However, the CloudMade company made their image and tile sources unavailable. As result, we have removed support for them in the XamGeographicMap and XamMap controls.

Below is a table of the classes that were removed, the control that is affected by this change, and the assembly that contained the removed class.

Affected Control Removed Classes Affected Assembly

CloudMadeMapImagery

InfragisticsWPF.Controls.Maps.XamGeographicMap

CloudMadeTileSource

InfragisticsWPF.DataVisualization

Move Classes

We moved some classes from the InfragisticsWPF.Controls.Maps.XamGeographicMap assembly in order to support new scatter series in the XamDataChart control and provide loading of shapefile in the XamShapeChart control. The following table lists all classes that were moved:

Affected Control Moved Classes New Assembly

all classes under namespace
Infragistics.Controls.Charts

InfragisticsWPF.Controls.Charts.XamDataChart`

AdvancedScatterSeriesRule
AdvancedSubCollectionsRule

InfragisticsWPF.Controls.Charts.XamDataChart

ShapefileConverter
ShapefileRecord
ShapefileRecordFields
ShapeType
StyleVisibilityConverter
ItfConverter
XBaseDataType
XBaseField

InfragisticsWPF.DataVisualization

xamGrid

Initial Column Pre-measuring and Rendering

The control now renders by default only the columns in view. Columns outside of the view are rendered once they come into view (for example when scrolling horizontally). If have control over this behavior using the MinimumNumberOfColumnsRendered property. By default its value is 0 which means that only the columns in view will be rendered, however you can set a value indicating how many columns you want to be pre-measured instead of virtualized. Please note that setting this property to higher values may lead to decreased performance results.

xamRadialGauge

Renamed event handler

Fixed misspelling in AlignLabel event handler. The old name was AlignRadialGaugeLabelHangler and the new name is AlignRadialGaugeLabelHandler.