Version

About Animations

The xamTileManager™ allows you to change or disable the default animations for tile positioning and/or resizing.

You can disable the animations by setting the NormalModeSettings and/or MaximizedModeSettings object’s ShouldAnimate property to False. If you disable animations, xamTileManager will also ignore any custom animations you supply.

If you want to set custom animation timings, you can set the NormalModeSettings and/or MaximizedModeSettings object’s RepositionAnimation and ResizeAnimation properties to objects that derive from the DoubleAnimationBase class. The double animation you provide should animate a double value from 0 to 1. However, you can temporarily go beyond this range using a DoubleAnimationUsingKeyFrames object as long as the last key frame ends with a value of 1. You can find a code example that demonstrates setting the RepositionAnimation and ResizeAnimation properties in the API Reference Guide

Note
Note:

The resize animation is applied when xamTileManager has to resize tiles between state transitions. The resize animation does not get applied when your end users resize a tile using the resizing indicators. However, if resizing a tile causes other tiles to come into view or move into a new column or row, the reposition animation will get applied.

The xamTileManager applies animations in the following circumstances:

Reposition Animation in Normal Mode

  • Dragging tiles into different positions

  • Scrolling tiles into view

  • Resizing xamTileManager so more tiles come into view or existing tiles are moved to new columns/rows

  • Changing a normal tile to a maximized tile

Resize Animation in Normal Mode (applied only when the size of a tile changes during a transition)

  • Changing a maximized, minimized or minimized-expanded tiles to a normal tile

Reposition Animation in Maximized Mode

  • Changing a normal, minimized or minimized-expanded tile to a maximized tile

  • Scrolling minimized or minimized-expanded tiles into view (this also includes tiles that come into view when you minimize a minimized-expanded tile or vice-versa)

Resize Animation in Maximized Mode (applied only when the size of a tile changes during a transition)

  • Changing a normal tile to a maximized, minimized or minimized-expanded tile

  • Changing minimized or minimized-expanded tiles to maximized tiles

Notifications

To receive notifications when the animation starts or ends hook at the following events:

To obtain the current state of the animation, use the IsAnimationInProgress property (Boolean, read-only).