Class RadCarousel

RadCarouses is a control that animates a group of items in Carousel-style rotation.

Inheritance
System.Object
RadControl
RadCarousel
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public class RadCarousel : RadControl, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider
Remarks

You can add item to RadCarousel control using Items collection, or through binding to data by assigning its DataSource properties. In order to manage the display of great number of items you may need to set the VirtualMode property to true. In this case you should specify the maximum visible number of item, using the VisibleItemCount property. Item path can be specified through CarouselPath property. Each carousel path instance contains properties to adjust various aspects of the path curve, including "start" and "end" position, selected items position. If you use a RadCarousel bound to a data, you would need to handle the ItemDataBound event to change each carouselItem's properties according to items in the data source. You may also need to handle the CreateNewCarouselItem event, to change the default type of items RadCarousel will produce when data binding.

Constructors

RadCarousel()

Declaration
public RadCarousel()

Properties

AnimationDelay

Gets or sets the delay in ms. between two frames of animation

Declaration
public int AnimationDelay { get; set; }
Property Value
System.Int32

AnimationFrames

Gets ot sets the number of animation frames between two positions

Declaration
public int AnimationFrames { get; set; }
Property Value
System.Int32

AnimationsToApply

Gets or sets value indicating which of the predefined animations will be applied to carousel items

Declaration
public Animations AnimationsToApply { get; set; }
Property Value
Animations

AutoLoopDirection

Gets or sets a value indicating whether carousel will increment or decrement item indexes when in auto-loop mode.

Declaration
public AutoLoopDirections AutoLoopDirection { get; set; }
Property Value
AutoLoopDirections

AutoLoopPauseCondition

Gets or sets a value indicating when carousel will pause looping if in auto-loop mode.

Declaration
public AutoLoopPauseConditions AutoLoopPauseCondition { get; set; }
Property Value
AutoLoopPauseConditions

AutoLoopPauseInterval

Gets or sets a value indicating the interval (in seconds) after which the carousel will resume looping when in auto-loop mode.

Declaration
public int AutoLoopPauseInterval { get; set; }
Property Value
System.Int32

AutoSize

Gets or sets whether the edit control is auto-sized

Declaration
public override bool AutoSize { get; set; }
Property Value
System.Boolean

Overrides

ButtonNext

Pressent the Next button

Declaration
public RadRepeatButtonElement ButtonNext { get; }
Property Value
RadRepeatButtonElement

ButtonPositions

Represent the Navigation buttons Positions

Declaration
public virtual NavigationButtonsPosition ButtonPositions { get; set; }
Property Value
NavigationButtonsPosition

ButtonPrevious

Present the Previous button

Declaration
public RadRepeatButtonElement ButtonPrevious { get; }
Property Value
RadRepeatButtonElement

CarouselElement

Gets a reference to the Carousel element, which encapsulates the most of the functionality of RadCarousel

Declaration
public RadCarouselElement CarouselElement { get; }
Property Value
RadCarouselElement

CarouselPath

Declaration
public CarouselParameterPath CarouselPath { get; set; }
Property Value
CarouselParameterPath

DataSource

Declaration
public object DataSource { get; set; }
Property Value
System.Object

DefaultSize

Gets the default size of the control.

Declaration
protected override Size DefaultSize { get; }
Property Value
System.Drawing.Size

EasingType

Declaration
public RadEasingType EasingType { get; set; }
Property Value
RadEasingType

EnableAnimationOnFormResize

Enable or disable the re-animation of RadCarousel on form maximize, minimize or resize

Declaration
public virtual bool EnableAnimationOnFormResize { get; set; }
Property Value
System.Boolean

EnableAutoLoop

Gets or sets a value indicating that the Carousel will loop items automatically

Declaration
public bool EnableAutoLoop { get; set; }
Property Value
System.Boolean

EnableKeyboardNavigation

Gets or sets a value indicating whether the keyboard navigation is enabled.

Declaration
public virtual bool EnableKeyboardNavigation { get; set; }
Property Value
System.Boolean

EnableLooping

Gets or sets value indicating that when item position goes beyond the carousel path, it will be displayed again in the beginning of the carousel path.

Declaration
public bool EnableLooping { get; set; }
Property Value
System.Boolean

EnableRelativePath

Declaration
public bool EnableRelativePath { get; set; }
Property Value
System.Boolean

FormattingEnabled

Gets or sets a value indicating whether formatting is applied to the DisplayMember property.

Declaration
public bool FormattingEnabled { get; set; }
Property Value
System.Boolean

ItemClickDefaultAction

Gets or sets the default action when item is clicked as CarouselItemClickAction member.

Declaration
public CarouselItemClickAction ItemClickDefaultAction { get; set; }
Property Value
CarouselItemClickAction

The item click default action.

ItemReflectionPercentage

Gets or sets value indicating the height (in percentage - values from 0.0. to 1.0) of reflection that will be painted bellow each carousel item.

Declaration
public double ItemReflectionPercentage { get; set; }
Property Value
System.Double

The item reflection percentage.
Remarks

0.0 indicates no reflection and 1.0 indicates 100% of the height of the original item

Items

Declaration
[RadEditItemsAction]
[RadDescription("Items", typeof(RadCarouselElement))]
public RadItemCollection Items { get; }
Property Value
RadItemCollection

MinFadeOpacity

Gets or sets value indicating the minimum value of the opacity applied to items

Declaration
public double MinFadeOpacity { get; set; }
Property Value
System.Double

NavigationButtonsOffset

Get or sets the minimum size to apply on an element when layout is calculated.

Declaration
public virtual Size NavigationButtonsOffset { get; set; }
Property Value
System.Drawing.Size

OpacityChangeCondition

Sets the way opacity is applied to carousel items

Declaration
public OpacityChangeConditions OpacityChangeCondition { get; set; }
Property Value
OpacityChangeConditions

SelectedIndex

Gets or sets the item in the carousel that is currently selected.

Declaration
public virtual int SelectedIndex { get; set; }
Property Value
System.Int32

SelectedItem

Declaration
public virtual object SelectedItem { get; set; }
Property Value
System.Object

SelectedValue

Declaration
public object SelectedValue { get; set; }
Property Value
System.Object

ValueMember

Gets or sets the field from the data source to use as the actual value for the carousel items.

Declaration
public string ValueMember { get; set; }
Property Value
System.String

VirtualMode

Get or sets value indicating the maximum number of items that will be displayed in the carousel, even when there are more Items in the Items collection. Virtualizing the carousel would significantly improve its performance.

Declaration
public bool VirtualMode { get; set; }
Property Value
System.Boolean

Remarks

False indicates that all items be displayed. It depends on SelectedIndex, which items are displayed in this case.

VisibleItemCount

Gets or sets the number of items that carousel displays when VirtualMode is set to true.

Declaration
public int VisibleItemCount { get; set; }
Property Value
System.Int32

Methods

ControlDefinesThemeForElement(RadElement)

Declaration
public override bool ControlDefinesThemeForElement(RadElement element)
Parameters
RadElement element

Returns
System.Boolean

Overrides

CreateChildItems(RadElement)

Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
RadElement parent

Overrides

GetInputElement()

Declaration
protected override RadElement GetInputElement()
Returns
RadElement

Overrides

OnLoad(Size)

Declaration
protected override void OnLoad(Size desiredSize)
Parameters
System.Drawing.Size desiredSize

Overrides

Events

ItemDataBound

Declaration
public event ItemDataBoundEventHandler ItemDataBound
Event Type
ItemDataBoundEventHandler

NewCarouselItemCreating

Declaration
public event NewCarouselItemCreatingEventHandler NewCarouselItemCreating
Event Type
NewCarouselItemCreatingEventHandler

SelectedIndexChanged

Declaration
public event EventHandler SelectedIndexChanged
Event Type
System.EventHandler

SelectedItemChanged

Declaration
public event EventHandler SelectedItemChanged
Event Type
System.EventHandler

SelectedValueChanged

Declaration
public event EventHandler SelectedValueChanged
Event Type
System.EventHandler

Extension Methods