New to Telerik UI for WPFStart a free 30-day trial

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:

C#
[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

Initializes a new instance of the RadCarousel class.

C#
public RadCarousel()

Fields

Identifies the AutoGenerateDataPresenters dependency property.

C#
public static readonly DependencyProperty AutoGenerateDataPresentersProperty

Identifies the HorizontalScrollBarVisibilityProperty dependency property.

C#
public static readonly DependencyProperty HorizontalScrollBarVisibilityProperty

ItemsPanelProperty

DependencyProperty

Identifies the ItemsPanel dependency property.

C#
public static readonly DependencyProperty ItemsPanelProperty

ItemTemplateProperty

DependencyProperty

Identifies the ItemTemplateProperty dependency property.

C#
public static readonly DependencyProperty ItemTemplateProperty

ReflectionSettingsProperty

DependencyProperty

Identifies the ReflectionSettingsProperty dependency property.

C#
public static readonly DependencyProperty ReflectionSettingsProperty

Identifies the VerticalScrollBarVisibilityProperty dependency property.

C#
public static readonly DependencyProperty VerticalScrollBarVisibilityProperty

Properties

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

C#
public bool AutoGenerateDataPresenters { get; set; }
Property Value:

true if auto generation is activated; otherwise, false.

FieldDescriptors

IList<IFieldDescriptor>

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

C#
public IList<IFieldDescriptor> FieldDescriptors { get; }
Property Value:

A generic list of field descriptor objects.

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

C#
public FilterDescriptorCollection FilterDescriptors { get; }
Property Value:

The filter descriptors.

Gets or sets the horizontal scroll bar visibility.

C#
public ScrollBarVisibility HorizontalScrollBarVisibility { get; set; }
Property Value:

The horizontal scroll bar visibility.

Gets the items control.

C#
public CarouselItemsControl ItemsControl { get; }
Property Value:

The items control.

ItemsPanel

ItemsPanelTemplate

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

C#
public ItemsPanelTemplate ItemsPanel { get; set; }

ItemTemplate

DataTemplate

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

C#
public DataTemplate ItemTemplate { get; set; }
Property Value:

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

Panel

Panel

Gets the panel that is set to the ItemsPanel property.

C#
public Panel Panel { get; }

Gets or sets the reflection settings.

C#
public ReflectionSettings ReflectionSettings { get; set; }
Property Value:

The reflection settings.

VerticalScrollBarVisibility

ScrollBarVisibility

Gets or sets the vertical scroll bar visibility.

C#
public ScrollBarVisibility VerticalScrollBarVisibility { get; set; }
Property Value:

The vertical scroll bar visibility.

Methods

Brings the specified data item into view.

C#
public void BringDataItemIntoView(object dataItem)
Parameters:dataItemobject

The data item.

Searches for a RadCarouselPanel .

C#
public RadCarouselPanel FindCarouselPanel()
Returns:

RadCarouselPanel

The RadCarouselPanel being used.

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

C#
public override void OnApplyTemplate()

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

C#
protected override AutomationPeer OnCreateAutomationPeer()
Returns:

AutomationPeer

The type-specific AutomationPeer implementation.

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

C#
protected override void OnInitialized(EventArgs e)
Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

Called when ItemsSource property has changed.

C#
protected override void OnItemsSourceChanged(object oldValue, object newValue)
Parameters:oldValueobject

The old value.

newValueobject

The new value.

Overrides: DataControl.OnItemsSourceChanged(object, object)

Resets the theme.

C#
public void ResetTheme()

Sets IsCurrent property.

C#
protected override void SetIsCurrent(object item, bool isCurrent)
Parameters:itemobject

The item.

isCurrentbool

If set to true [is current].

Overrides: DataControl.SetIsCurrent(object, bool)

Sets the is selected.

C#
protected override void SetIsSelected(object item, bool isSelected)
Parameters:itemobject

The item.

isSelectedbool

If set to true [is selected].

Overrides: DataControl.SetIsSelected(object, bool)