Class
RadCarousel

Represents a powerful navigation control that displays a collection of items in a carousel format. It integrates with various data sources and provides features such as touch interaction, automatic data presenter generation, and customizable item templates. The RadCarouselPanel is used for layout management, enabling developers to create visually appealing data presentations. This control supports automatic filtering, selection modes, and reflective item presentation, making it suitable for both simple and complex data visualization scenarios.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.Navigation.dll

Syntax:

cs-api-definition
[TelerikToolboxCategory("Navigation")]
[Themable]
public class RadCarousel : DataControl, INotifyPropertyChanged

Inheritance: objectDataControlRadCarousel

Implements: INotifyPropertyChanged

Inherited Members DataControl.ItemsSourcePropertyDataControl.CurrentItemPropertyDataControl.SelectedItemPropertyDataControl.CanUserSelectPropertyDataControl.IsSynchronizedWithCurrentItemPropertyDataControl.SelectionChangedEventDataControl.SelectionChangingEventDataControl.OnItemsPropertyChanged(object, PropertyChangedEventArgs)DataControl.OnItemsCollectionChanged(object, NotifyCollectionChangedEventArgs)DataControl.Rebind()DataControl.CreateTableDefinition()DataControl.OnPropertyChanged(string)DataControl.OnCurrentItemChanged()DataControl.OnSelectedItemChanged(object, object)DataControl.OnCanUserSelectChanged(bool, bool)DataControl.RaiseSelectionChangedEvent(SelectionChangeEventArgs)DataControl.OnSelectionChanging(SelectionChangingEventArgs)DataControl.InitializeSelection()DataControl.ItemsDataControl.ItemsSourceDataControl.TableDefinitionDataControl.CurrentItemDataControl.SelectedItemDataControl.CanUserSelectDataControl.IsSynchronizedWithCurrentItemDataControl.ShouldHandleSelectionDataControl.SelectedItemsDataControl.PropertyChangedDataControl.SelectionChangedDataControl.SelectionChanging

Constructors

RadCarousel()

Initializes a new instance of the RadCarousel class.

Declaration

cs-api-definition
public RadCarousel()

Fields

AutoGenerateDataPresentersProperty

Identifies the AutoGenerateDataPresenters dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty AutoGenerateDataPresentersProperty

Field Value

DependencyProperty

HorizontalScrollBarVisibilityProperty

Identifies the HorizontalScrollBarVisibilityProperty dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty HorizontalScrollBarVisibilityProperty

Field Value

DependencyProperty

ItemTemplateProperty

Identifies the ItemTemplateProperty dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ItemTemplateProperty

Field Value

DependencyProperty

ItemsPanelProperty

Identifies the ItemsPanel dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ItemsPanelProperty

Field Value

DependencyProperty

ReflectionSettingsProperty

Identifies the ReflectionSettingsProperty dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ReflectionSettingsProperty

Field Value

DependencyProperty

VerticalScrollBarVisibilityProperty

Identifies the VerticalScrollBarVisibilityProperty dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty VerticalScrollBarVisibilityProperty

Field Value

DependencyProperty

Properties

AutoGenerateDataPresenters

Gets or sets a value indicating whether data presenters should be automatically created.

Declaration

cs-api-definition
public bool AutoGenerateDataPresenters { get; set; }

Property Value

bool

true if auto generation is activated; otherwise, false.

FieldDescriptors

Gets the collection of all field descriptors that appear in the control.

Declaration

cs-api-definition
public IList<IFieldDescriptor> FieldDescriptors { get; }

Property Value

IList<IFieldDescriptor>

A generic list of field descriptor objects.

FilterDescriptors

Gets a collection of Telerik.Windows.Data.FilterDescriptor objects used to filter the items collection of this instance.

Declaration

cs-api-definition
public FilterDescriptorCollection FilterDescriptors { get; }

Property Value

FilterDescriptorCollection

The filter descriptors.

HorizontalScrollBarVisibility

Gets or sets the horizontal scroll bar visibility.

Declaration

cs-api-definition
public ScrollBarVisibility HorizontalScrollBarVisibility { get; set; }

Property Value

ScrollBarVisibility

The horizontal scroll bar visibility.

ItemTemplate

Gets or sets the DataTemplate used to display each item. This is a dependency property.

Declaration

cs-api-definition
public DataTemplate ItemTemplate { get; set; }

Property Value

DataTemplate

A DataTemplate that specifies the visualization of the data objects. The default is null.

ItemsControl

Gets the items control.

Declaration

cs-api-definition
public CarouselItemsControl ItemsControl { get; }

Property Value

CarouselItemsControl

The items control.

ItemsPanel

Gets or sets the template that defines the panel that controls the layout of items. This is a dependency property.

Declaration

cs-api-definition
public ItemsPanelTemplate ItemsPanel { get; set; }

Property Value

ItemsPanelTemplate

Panel

Gets the panel that is set to the ItemsPanel property.

Declaration

cs-api-definition
public Panel Panel { get; }

Property Value

Panel

ReflectionSettings

Gets or sets the reflection settings.

Declaration

cs-api-definition
public ReflectionSettings ReflectionSettings { get; set; }

Property Value

ReflectionSettings

The reflection settings.

VerticalScrollBarVisibility

Gets or sets the vertical scroll bar visibility.

Declaration

cs-api-definition
public ScrollBarVisibility VerticalScrollBarVisibility { get; set; }

Property Value

ScrollBarVisibility

The vertical scroll bar visibility.

Methods

BringDataItemIntoView(object)

Brings the specified data item into view.

Declaration

cs-api-definition
public void BringDataItemIntoView(object dataItem)

Parameters

dataItem

object

The data item.

FindCarouselPanel()

Searches for a RadCarouselPanel .

Declaration

cs-api-definition
public RadCarouselPanel FindCarouselPanel()

Returns

RadCarouselPanel

The RadCarouselPanel being used.

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes call ApplyTemplate.

Declaration

cs-api-definition
public override void OnApplyTemplate()

OnCreateAutomationPeer()

Returns class-specific AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

The type-specific AutomationPeer implementation.

OnInitialized(EventArgs)

Raises the event. This method is invoked whenever is set to true internally.

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

The RoutedEventArgs that contains the event data.

OnItemsSourceChanged(object, object)

Called when ItemsSource property has changed.

Declaration

cs-api-definition
protected override void OnItemsSourceChanged(object oldValue, object newValue)

Parameters

oldValue

object

The old value.

newValue

object

The new value.

Overrides DataControl.OnItemsSourceChanged(object, object)

ResetTheme()

Resets the theme.

Declaration

cs-api-definition
public void ResetTheme()

SetIsCurrent(object, bool)

Sets IsCurrent property.

Declaration

cs-api-definition
protected override void SetIsCurrent(object item, bool isCurrent)

Parameters

item

object

The item.

isCurrent

bool

If set to true [is current].

Overrides DataControl.SetIsCurrent(object, bool)

SetIsSelected(object, bool)

Sets the is selected.

Declaration

cs-api-definition
protected override void SetIsSelected(object item, bool isSelected)

Parameters

item

object

The item.

isSelected

bool

If set to true [is selected].

Overrides DataControl.SetIsSelected(object, bool)