RadRotatorItem
The RadItem that implements the actual RadRotator's functionality.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadRotatorItem : RadItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadRotatorItem...
Implements:
Inherited Members
Constructors
public RadRotatorItem()
Fields
Identifies the property that stores animation settings for the item entering the display during a swap.
public static RadProperty fadeInProperty
Properties
Gets or Sets the swap animation's frames number
public int AnimationFrames { get; set; }
Gets or Sets the index of the current item. Note: When setting the current item, the old and the new item will be swapped.
[Browsable(false)]
public int CurrentIndex { get; set; }
Gets the current item.
[Browsable(false)]
public RadItem CurrentItem { get; }
fadeIn
List<AnimatedPropertySetting>
Gets or sets the animation settings assembled for the item entering the display during a swap.
public List<AnimatedPropertySetting> fadeIn { get; set; }
The rotator replaces this transient list when it starts another swap; item-specific animation settings are combined into it.
Gets or Sets the interval between consecutive rotation animations.
public int Interval { get; set; }
Gets the collection of RadItems that will be rotated.
public RadItemOwnerCollection Items { get; }
Gets or Sets value defining the initial position of the incomming item and the final position of the outgoing item. Note: The position is relative, in the range [-1, 1] for each of the components (X, Y). Value of positive or negative 1 means that the object will not be in the visible area before the animation begins (for the incomming item) or after it ends (for the outgoing item)
public SizeF LocationAnimation { get; set; }
Gets or Sets value indicating whether opacity will be animated when switching frames
public bool OpacityAnimation { get; set; }
Gets or Sets value indicating whether the RadRotator is started/stopped.
[Browsable(false)]
public bool Running { get; set; }
Gets or sets whether RadRotator should stop rotating on MouseOver
public bool ShouldStopOnMouseOver { get; set; }
Methods
Disposes the timer used to advance rotations before disposing the base item resources.
protected override void DisposeManagedResources()
Overrides:
Makes transition to the default element.
Initializes the allowed-item collection and the timer used to advance rotations.
protected override void InitializeFields()
Overrides:
Raises BeginRotate before the incoming item is swapped into view.
protected virtual void OnBeginRotate(object sender, BeginRotateEventArgs e)
Handlers can cancel the swap or change the requested destination through To.
protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)
Overrides:
Raises EndRotate after the transition animations finish.
protected virtual void OnEndRotate(object sender, EventArgs e)
If a stop was deferred until the animations finished, this method also raises StopRotation after EndRotate.
Raises ItemClicked when the currently displayed item is clicked.
Called when a property value has changed, handling item-specific property change logic including text, visual state, and animation properties.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
The property changed event arguments.
Overrides:
Raises the cancellable StartRotation event before starting the rotation timer.
protected virtual void OnStartRotation(object sender, CancelEventArgs e)
If a handler sets Cancel, Start(bool) does not start rotation.
Raises StopRotation after rotation stops.
Moves to the previous item.
Starts cycling through the elements in the Items collection
Stops the rotation process. If swap is under way, it will be completed.
public void Stop()
Events
Fires before RadItems' swap begins.
public event BeginRotateEventHandler BeginRotate
Fires when RadItems' swap has finished.
public event EventHandler EndRotate
Fires when an Item is clicked
public event EventHandler ItemClicked
Fires when RadRotator is started.
public event CancelEventHandler StartRotation
Fires when RadRotator is stopped.
public event EventHandler StopRotation