ClassRadSlideView
A navigation control that allows you to slide between different views with support for data binding, animation, and customizable templates.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Data Controls")]
public class RadSlideView : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadSlideView
Implements:
Inherited Members
Constructors
RadSlideView()
Initializes a new instance of the RadSlideView class.
Declaration
public RadSlideView()
Properties
AllowAnimation
Gets or sets a value indicating whether to use animation when transitioning between slides.
AnimationEasingType
Gets or sets the easing type used for slide transition animations to control the acceleration and deceleration of the animation.
Declaration
public RadEasingType AnimationEasingType { get; set; }
Property Value
AnimationFrames
Gets or sets the number of frames used for slide transition animations.
AnimationInterval
Gets or sets the time interval in milliseconds between animation frames during slide transitions.
AnimationType
Gets or sets the type of animation that is executed when transitioning between slides.
Declaration
public AnimationType AnimationType { get; set; }
Property Value
AutoHideButtonsDelay
Gets or sets the delay in milliseconds before the navigation buttons are hidden after the mouse leaves the control. This property is only used when ButtonsVisibility is set to VisibleOnMouseOver.
BindingSource
Gets or sets the data source for data binding scenarios. When set, the control will automatically generate slides based on the data source items.
Declaration
[Browsable(true)]
public BindingSource BindingSource { get; set; }
Property Value
ButtonsVisibility
Gets or sets how the navigation buttons are displayed - whether they are always visible, hidden, or visible only on mouse over.
Declaration
public ButtonsVisibility ButtonsVisibility { get; set; }
Property Value
DefaultSize
Gets the default size of the RadSlideView when a new instance is initialized.
Declaration
protected override Size DefaultSize { get; }
Property Value
Overrides
IsInfiniteScrollingEnabled
Gets or sets a value indicating whether infinite scrolling from the last item to the first item and vice versa is enabled.
Declaration
public bool IsInfiniteScrollingEnabled { get; set; }
Property Value
Mappings
Gets the mappings collection that provides options to map properties from the TemplateElement to the data bound object. Mappings are used only in bound mode.
NumberOfPages
Gets or sets the number of pages to display. If BindingSource is set, this property returns the Count value.
Orientation
Gets or sets the orientation of the navigation buttons - either horizontal or vertical.
Declaration
public Orientation Orientation { get; set; }
Property Value
SelectedIndex
Gets or sets the zero-based index of the currently selected slide.
ShowButtonsOverContent
Gets or sets a value indicating whether the navigation buttons will be displayed over the content or outside it. The default value is true, which displays the buttons over the content.
SlideViewElement
Gets the main slide view element that handles the core functionality of the control.
Declaration
[Browsable(false)]
public RadSlideViewElement SlideViewElement { get; }
Property Value
TemplateElement
Gets or sets the template element that is responsible for displaying the content of each slide.
Declaration
public LightVisualElement TemplateElement { get; set; }
Property Value
Methods
CanSelectNext()
Determines whether moving to the next slide is possible based on the current selection and infinite scrolling settings.
Declaration
public bool CanSelectNext()
Returns
True if moving to the next slide is possible; otherwise, false
CanSelectPrevious()
Determines whether moving to the previous slide is possible based on the current selection and infinite scrolling settings.
Declaration
public bool CanSelectPrevious()
Returns
True if moving to the previous slide is possible; otherwise, false
CreateAccessibilityInstance()
Creates the accessibility instance for this control to support screen readers and other accessibility tools.
Declaration
protected override AccessibleObject CreateAccessibilityInstance()
Returns
An AccessibleObject instance for this control
Overrides
CreateChildItems(RadElement)
Creates the child items for this control by adding the main slide view element to the parent container.
Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
parent
The parent element that will contain the child items
Overrides
CreateRadSlideViewElement()
Creates a new instance of the RadSlideViewElement that will serve as the main element for this control.
Declaration
protected virtual RadSlideViewElement CreateRadSlideViewElement()
Returns
A new RadSlideViewElement instance
IsInputKey(Keys)
Determines whether the specified key is an input key that should be processed by the control.
OnGotFocus(EventArgs)
Handles the GotFocus event by passing focus to the internal slide view element.
Declaration
protected override void OnGotFocus(EventArgs e)
Parameters
e
An EventArgs that contains the event data
Overrides
Select(int)
Selects the slide at the specified index without animation.
Declaration
public void Select(int index)
Parameters
index
The zero-based index of the slide to select
Select(int, bool)
Selects the slide at the specified index with an option to animate the transition.
SelectNext()
Moves the selection to the next slide if possible.
Declaration
public void SelectNext()
SelectPrevious()
Moves the selection to the previous slide if possible.
Declaration
public void SelectPrevious()
UpdateVisibility()
Updates the visibility of navigation buttons and other visual elements based on the current state and settings.
Declaration
public virtual void UpdateVisibility()
Events
AnimationFinished
Occurs when a slide transition animation is finished.
Declaration
public event AnimationFinishedEventHandler AnimationFinished
Event Value
AnimationStarted
Occurs when a slide transition animation is started.
Declaration
public event AnimationStartedEventHandler AnimationStarted
Event Value
MappedPropertyUpdating
Occurs when a mapped property value is extracted from the data object and is about to be applied to the mapped template property. This event allows synchronization of value data types to match the destination template property type. For example if the mapped property is of type integer and the template property is of type string, this event allows to synchronize value data type to the mapped template property data type. NOTE that, if the value data type does not match the template property type, the property value will be reset. This event is fired only in bound mode when BindingSource is set. For unbound mode(when NumberOfPages is used) handle the TemplateUpdated event.
Declaration
public event UpdateMappedPropertyEventHandler MappedPropertyUpdating
Event Value
SelectedIndexChanged
Occurs when the selected index has changed to a different slide.
Declaration
public event RadSelectedIndexChangedEventHandler SelectedIndexChanged
Event Value
TemplateUpdated
Occurs when all mappings have been applied, just before the slide is changed. This event is suitable for changing template styles or properties.
Declaration
public event TemplateUpdatedEventHandler TemplateUpdated
Event Value