Silverlight Toolkit July 2009 changes

The following list encompasses all changes made between the Silverlight Toolkit March 2009 release and the Silverlight Toolkit July 2009 release. To see previous changes see the Silverlight Toolkit December 2008 change list and the Silverlight Toolkit March 2009 change list.

NOTE: If you're migrating from Silverlight 2 or Silverlight 3 Beta to Silverlight 3 then it might be helpful to review the following document: Ensuring That Your Silverlight 2 Applications Work with Silverlight 3.

New Controls

GlobalCalendar

GlobalCalendar provides an easy way to style individual days as well abstracting out calendar logic allowing the ability to define custom Gregorian calendars.

• Same API as Calendar with two new properties: CalendarDayButtonStyleSelector and CalendarInfo.
• New: Hotkey Ctrl + Home selects the current date or extends the current selection when used in conjunction with Shift.

Rating

Represents a control that can be used to display or allow users to interactively select a rating value. Ratings can be whole or partial stars. By default the control displays stars but can be easily styled to use a different rating metaphor.

TreeMap

The TreeMap visualisation displays a hierarchy of data as a set of nested rectangles, where the area of each rectangle represents a chosen metric from the data. Through the use of Interpolators, other properties such as background colour, font size and font colour can be varied to represent other metrics. TemplateSelectors allow the control to be easily extended to have different layouts or color schemes for different levels or branches within the hierarchy.

New Extensions

ItemsControlExtensions

Provides useful extensions to ItemsControl:

• Get various collections representing the items and their containers.
• Get an items host or ScrollViewer.

ScrollViewerExtensions

Provides useful extensions to ScrollViewer to make basic scrolling tasks easier:

• Enable mouse wheel scrolling in XAML!
• Scroll by page or line.
• Scroll to top, bottom, left or right.
• Scroll items into view.

TreeViewExtensions

Provides useful extensions to TreeView and TreeViewItem to greatly simplify common TreeView tasks:

• Set selected item
• Easily add connecting lines and CheckBoxes
• Expand and collapse items.
• Get items and their containers for parents, siblings and descendants.
• Get path.

Breaking Change: DataForm, DockPanel, WrapPanel, Expander, HeaderedContentControl and Viewbox moved from Silverlight 3 SDK Beta into the Silverlight Toolkit July 2009.

In the Silverlight 3 Beta SDK the above mentioned controls were contained in the SDK. When updating any Silverlight 3 Beta application to Silverlight 3 you'll need to add the appropriate assemblies listed below as well as adjust the namespace prefix.

Control \ Silverlight Version	Silverlight 2 Required Assemblies	Silverlight 3 Required Assemblies
TreeView	System.Windows.Controls.Toolkit.dll	System.Windows.Controls.dll
HeaderedContentControl	System.Windows.Controls.Toolkit.dll	System.Windows.Controls.Toolkit.dll
HeaderedItemsControl	System.Windows.Controls.Toolkit.dll	System.Windows.Controls.dll
DockPanel	System.Windows.Controls.Toolkit.dll	System.Windows.Controls.Toolkit.dll
WrapPanel	System.Windows.Controls.Toolkit.dll	System.Windows.Controls.Toolkit.dll
Expander	System.Windows.Controls.Toolkit.dll	System.Windows.Controls.Toolkit.dll
ViewBox	System.Windows.Controls.Toolkit.dll	System.Windows.Controls.Toolkit.dll
Label	System.Windows.Controls.Toolkit.dll	System.Windows.Controls.Data.Input.dll
AutoCompleteBox	System.Windows.Controls.Input.Toolkit.dll & System.Windows.Controls.Toolkit.dll	System.Windows.Controls.Input.dll & System.Windows.Controls.dll
GridSplitter	System.Windows.Controls.dll	System.Windows.Controls.dll
TabControl	System.Windows.Controls.dll	System.Windows.Controls.dll
DatePicker	System.Windows.Controls.dll	System.Windows.Controls.dll
Calendar	System.Windows.Controls.dll	System.Windows.Controls.dll
DataVisualization/Charting	System.Windows.Controls.DataVisualization.Toolkit.dll	System.Windows.Controls.DataVisualization.Toolkit.dll
ImplicitStyleManager	System.Windows.Controls.Theming.Toolkit.dll	System.Windows.Controls.Theming.Toolkit.dll
Any Theme	System.Windows.Controls.Theming.ThemeName.Toolkit.dll & System.Windows.Controls.Theming.Toolkit.dll	System.Windows.Controls.Theming.ThemeName.Toolkit.dll & System.Windows.Controls.Theming.Toolkit.dll
Accordion	System.Windows.Controls.Layout.Toolkit.dll & System.Windows.Controls.Toolkit.dll & System.Windows.Controls.dll	System.Windows.Controls.Layout.Toolkit.dll & System.Windows.Controls.Toolkit.dll & System.Windows.Controls.dll
LayoutTransformer	System.Windows.Controls.Layout.Toolkit.dll & System.Windows.Controls.Toolkit.dll & System.Windows.Controls.dll	System.Windows.Controls.Layout.Toolkit.dll & System.Windows.Controls.Toolkit.dll & System.Windows.Controls.dll
TransitioningContentControl	System.Windows.Controls.Layout.Toolkit.dll & System.Windows.Controls.Toolkit.dll & System.Windows.Controls.dll	System.Windows.Controls.Layout.Toolkit.dll
NumericUpDown	System.Windows.Controls.Input.Toolkit.dll & System.Windows.Controls.Toolkit.dll & System.Windows.Controls.dll	System.Windows.Controls.Input.Toolkit.dll & System.Windows.Controls.dll
TimeUpDown	System.Windows.Controls.Input.Toolkit.dll & System.Windows.Controls.Toolkit.dll & System.Windows.Controls.dll	System.Windows.Controls.Input.Toolkit.dll & System.Windows.Controls.dll
TimePicker	System.Windows.Controls.Input.Toolkit.dll & System.Windows.Controls.Toolkit.dll & System.Windows.Controls.dll	System.Windows.Controls.Input.Toolkit.dll & System.Windows.Controls.dll
DomainUpDown	System.Windows.Controls.Input.Toolkit.dll & System.Windows.Controls.Toolkit.dll & System.Windows.Controls.dll	System.Windows.Controls.Input.Toolkit.dll & System.Windows.Controls.dll
DataGrid	System.Windows.Controls.Data.dll	System.Windows.Controls.Data.dll & System.Windows.Controls.Data.Input.dll & System.ComponentModel.DataAnnotations.dll & System.Windows.Data_
Page	N\A	System.Windows.Controls.Navigation
Frame	N\A	System.Windows.Controls.Navigation
DataForm	N\A	System.ComponentModel.DataAnnotations & System.Windows.Controls & System.Windows.Controls.Data.DataForm.Toolkit & System.Windows.Controls.Data.Input &
ValidationSummary	N\A	System.Windows.Controls.Data.Input
DataPager	N\A	System.Windows.Controls.Data _& System.Windows.Data
Label	N\A	System.Windows.Controls.Data.Input
DescriptionViewer	N\A	System.Windows.Controls.Data.Input

Accordion

• Breaking Change: Removed HeaderTemplate on Accordion, use ItemTemplate.
• New: Accordion introduces AccordionButtonStyle making the scenarios where you would like to set the ClickMode to hover on the AccordionItems easy.
• Accordion reacts to size changes on both content and header and will trigger a new layout-pass.
• AccordionItem will treat its content the same as Grid, making scrollbars visible on content that supports it. AccordionItem no longer has a ScrollViewer in its template.
• AccordionItem makes content sizing easy by setting Horizontal/Vertical-ContentAlignment.
• AccordionItem now exposes a TargetSize property, allowing you to do calculations of expected size versus current size.
• Header is databound making databinding straightforward.
• Accordion is able to work with duplicate items (using the SelectedIndices property)
• Design-time experience is improved; allowing AccordionItems to open inside Blend.
• Lots of layout improvements.
• Various minor bug fixes.
• Fixed: Accordion(HeaderedContentControl) Header Template Binding Issue
• Fixed: Accordion expander image alignment in the center of the header text
• Fixed: Accordion, unable to stretch AccordionItem's content to occupy the entire available space
• Fixed: Accordion items don't stretch while selected when sizing browser window
• Fixed: Scrollbar doesn't show up for accordion item's content when shrinking browser window
• Fixed: Accordion doesn't occupy the entire available space while ExpandDirection="Right" & HorizontalAlignment="Stretch"
• Fixed: AccordionItems do not grow vertically when child controls grow
• Fixed: Silverlight Toolkit for SL3 Beta Accordion Returns runtime error
• Fixed: Suggestion: Add ClickMode property to Accordion control

AutoCompleteBox (released as part of the SDK)

• Breaking Change: The "DropDownToggle" template part of type ToggleButton has been removed.
• Breaking Change: New template part: “Selector”, typeof(Selector).
• Breaking Change: Renamed virtual method: TryGetSelectionAdapter(object o) is now GetSelectionAdapterPart().
• Breaking Change: AutoCompleteSearchMode is now AutoCompleteFilterMode (enum).
• Breaking Change: The SearchMode dependency property is now FilterMode.
• Breaking Change: AutoCompleteSearchPredicate delegate is now AutoCompleteFilterPredicate.
• Fixed: AutoCompleteBox: Change HasFocus() from private to public (or at least protected).

Charting

• WPF is now an official platform for Charting!
• Breaking Change: IRequireGlobalSeriesIndex's GlobalSeriesIndexChanged method takes a nullable int parameter.
• Improved performance of internal data structures for many common scenarios.
• Numerous bug fixes for animation inconsistencies between Silverlight and WPF.
• Fixed handling of data objects with non-unique hash codes.
• Corrected behavior of charts at very small sizes and during animations.
• Proper RoutedEvent support for DataPointSeries.SelectionChangedEvent.
• Better handling of non-double data by shared Series.
• Addition of StrokeMiterLimit to the Polyline used by LineSeries.
• Fixes for edge case scenarios when removing a Series.
• Ability to set Series.Title with a Binding (on Silverlight 3 and WPF).
• Automatic inheritance of the Foreground property by the Title control.
• Visual improvements to the LegendItem DataPoint marker.
• Significant BubbleSeries performance improvement.
• Fixed: Removing a PieSeries from a Chart's Series collection causes a NullReferenceException
• Fixed: Chart series title not binding

DockPanel

• Breaking Change: Moved from Silverlight 3 Beta SDK to Silverlight 3 Toolkit July 2009.

DataForm Breaking Changes

• Moved from Silverlight 3 Beta SDK to Silverlight 3 Toolkit July 2009.
• DataFormFields have all been removed and DataForm.Fields collection has been removed. They have been replaced with the new DataField control, which is a control that wraps content with a label and DescriptionViewer.
• Must now explicitly specify Mode=TwoWay on bindings in the DataField.
• FieldEditEnding and FieldEditEnded have been removed.
• GetFieldElement() has been removed.
• ItemEditEnding, ItemEditEnded, CommitItemEdit() have been changed to EditEnding, EditEnded, and CommitEdit() respectively.
• CanMoveToXXXXItem have been removed, as they can be derived from the collection given to the DataForm.
• CanUserAdd/DeleteItems have been removed, as they are implied through CommandButtonsVisibility.
• IsEditing and IsAddingItem have been removed, as they are implied through Mode.
• FieldLabelPosition and FieldLabelStyle have become LabelPosition and LabelStyle.
• WrapAfter and Orientation have been removed.
• The type names DataFormFieldLabelPosition and DataFormDescriptionViewerPosition have been changed to DataFieldLabelPosition and DataFieldDescriptionViewerPosition.

DomainUpDown

• Space bar now moves the DomainUpDown into edit mode.
• Better handling of mouse-events in edit mode.
• Fixed: SL2 Input control DomainUpDown

Expander

• Breaking Change: Moved from Silverlight 3 Beta SDK to Silverlight 3 Toolkit July 2009.

HeaderedContentControl

• Breaking Change: Moved from Silverlight 3 Beta SDK to Silverlight 3 Toolkit July 2009.
• Fixed: HeaderedContentControl throws exception when its content is replaced (under some condition)

Navigation (released as part of the SDK)

• New: Pages can be “cached” so they can be re-used on subsequent navigation to the same URI.

TabControl

• Fixed: Changing TabControl tabs causing TreeView.SelectionItemChanged event to fire on every node

TimePicker / TimeUpDown

• Setting an initial value will be propagated correctly.
• Full UI Automation hierarchy implimented.
• Renamed the BalloonHint states to TimeHint.
• Various minor bug fixes.
• Fixed: TimePicker does not show initial Value set in Xaml
• Fixed: Buttonspinner disabled state is unnecessary
• Fixed: TimePicker - Not able to select a time in dropdown list that is already selected by clicking or with enter key

TransitioningContentControl

• Changed the template to have two ContentPresenters instead of ContentControls.
• Fixed bug where switching between content would raise exception in certain scenarios.
• Handles setting the Transition to a transition that is not yet there (if template hasn’t been loaded yet).
• Fixed: System.ArgumentException while using TransitioningContentControl

TreeView (released as part of the SDK)

• Fixed: TreeView Scrolls when adding new TreeViewItems
• Fixed: TreeView: The App crashes when we add a button as TreeViewItem content

Themes

• Fixed: BureauBlueTheme PasswordBox Style always displays vertical scrollbar

ValidationSummary (released as part of the SDK)

• The control formally known as ErrorSummary is now ValidationSummary.

Viewbox

• Breaking Change: Moved from Silverlight 3 Beta SDK to Silverlight 3 Toolkit July 2009.

WrapPanel

• Breaking Change: Moved from Silverlight 3 Beta SDK to Silverlight 3 Toolkit July 2009.