Class RadSlideView

A navigation control that allows you to slide between different views with support for data binding, animation, and customizable templates.

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

Syntax

[TelerikToolboxCategory("Data Controls")]
public class RadSlideView : RadControl, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider

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.

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

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
RadEasingType

AnimationFrames

Gets or sets the number of frames used for slide transition animations.

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

AnimationInterval

Gets or sets the time interval in milliseconds between animation frames during slide transitions.

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

AnimationType

Gets or sets the type of animation that is executed when transitioning between slides.

Declaration
public AnimationType AnimationType { get; set; }
Property Value
AnimationType

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.

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

AutoSize

This property is not relevant for RadSlideView and always returns false.

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

Overrides

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
public BindingSource BindingSource { get; set; }
Property Value
System.Windows.Forms.BindingSource

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
ButtonsVisibility

DefaultSize

Gets the default size of the RadSlideView when a new instance is initialized.

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

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
System.Boolean

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.

Declaration
public List<Mapping> Mappings { get; }
Property Value
System.Collections.Generic.List<Mapping>

NumberOfPages

Gets or sets the number of pages to display. If BindingSource is set, this property returns the System.Windows.Forms.BindingSource.Count value.

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

Orientation

Gets or sets the orientation of the navigation buttons - either horizontal or vertical.

Declaration
public Orientation Orientation { get; set; }
Property Value
System.Windows.Forms.Orientation

SelectedIndex

Gets or sets the zero-based index of the currently selected slide.

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

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.

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

SlideViewElement

Gets the main slide view element that handles the core functionality of the control.

Declaration
public RadSlideViewElement SlideViewElement { get; }
Property Value
RadSlideViewElement

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
LightVisualElement

Text

This property is not relevant for RadSlideView.

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

Overrides

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
System.Boolean

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
System.Boolean

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
System.Windows.Forms.AccessibleObject

An AccessibleObject instance for this control

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
RadElement 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
RadSlideViewElement

A new RadSlideViewElement instance

IsInputKey(Keys)

Determines whether the specified key is an input key that should be processed by the control.

Declaration
protected override bool IsInputKey(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

The key data to evaluate
Returns
System.Boolean

True if the key is an input key; otherwise, false
Overrides

OnGotFocus(EventArgs)

Handles the GotFocus event by passing focus to the internal slide view element.

Declaration
protected override void OnGotFocus(EventArgs e)
Parameters
System.EventArgs e

An EventArgs that contains the event data
Overrides

Select(Int32)

Selects the slide at the specified index without animation.

Declaration
public void Select(int index)
Parameters
System.Int32 index

The zero-based index of the slide to select

Select(Int32, Boolean)

Selects the slide at the specified index with an option to animate the transition.

Declaration
public void Select(int index, bool animate)
Parameters
System.Int32 index

The zero-based index of the slide to select
System.Boolean animate

A value indicating whether to animate the selection process

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 Type
AnimationFinishedEventHandler

AnimationStarted

Occurs when a slide transition animation is started.

Declaration
public event AnimationStartedEventHandler AnimationStarted
Event Type
AnimationStartedEventHandler

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 Type
UpdateMappedPropertyEventHandler

SelectedIndexChanged

Occurs when the selected index has changed to a different slide.

Declaration
public event RadSelectedIndexChangedEventHandler SelectedIndexChanged
Event Type
RadSelectedIndexChangedEventHandler

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 Type
TemplateUpdatedEventHandler

Extension Methods