ClassRadPipsPager
Represents a control that enables navigation within linearly paginated content using visual pip indicators. Can be used as a navigation assistant for other controls such as the RadSlideView.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Data Controls")]
public class RadPipsPager : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadPipsPager
Implements:
Inherited Members
Constructors
RadPipsPager()
Initializes a new instance of the RadPipsPager class with default settings.
Declaration
public RadPipsPager()
Properties
AllowAnimation
Gets or sets a value indicating whether to use animation when transitioning between pip selections.
AnimationEasingType
Gets or sets the easing type used for pip 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 pip transition animations.
AnimationInterval
Gets or sets the time interval in milliseconds between animation frames during pip transitions.
AutoHideButtonsDelay
Gets or sets the delay in milliseconds before the navigation buttons are hidden after the mouse leaves the control. Used only when the ButtonsVisibility is VisibleOnMouseOver.
BindingSource
Gets or sets the data source for data binding scenarios. When set, the control will automatically generate pips 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 RadPipsPager 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 pip to the first pip and vice versa is enabled.
Declaration
public bool IsInfiniteScrollingEnabled { get; set; }
Property Value
ItemSize
Gets or sets the size of the individual pip items displayed in the control.
MaxVisiblePips
Gets or sets the maximum number of visible pip items displayed in the control at any given time.
NumberOfPages
Gets or sets the total number of pages in the pagination. If BindingSource is set, this property returns the Count.
Orientation
Gets or sets the orientation of the pip items - either horizontal or vertical arrangement.
Declaration
public Orientation Orientation { get; set; }
Property Value
PipsPagerElement
Gets the main pips pager element that handles the core functionality of the control.
Declaration
[Browsable(false)]
public RadPipsPagerElement PipsPagerElement { get; }
Property Value
SelectedIndex
Gets or sets the zero-based index of the currently selected pip item.
Methods
CanSelectNext()
Determines whether moving to the next pip is possible based on the current selection and infinite scrolling settings.
Declaration
public bool CanSelectNext()
Returns
True if moving to the next pip is possible; otherwise, false
CanSelectPrevious()
Determines whether moving to the previous pip is possible based on the current selection and infinite scrolling settings.
Declaration
public bool CanSelectPrevious()
Returns
True if moving to the previous pip 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 pips pager element to the parent container.
Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
parent
The parent element that will contain the child items
Overrides
CreateRadPipsPagerElement()
Creates a new instance of the RadPipsPagerElement that will serve as the main element for this control.
Declaration
protected virtual RadPipsPagerElement CreateRadPipsPagerElement()
Returns
A new RadPipsPagerElement instance
IsInputKey(Keys)
Determines whether the specified key is an input key that should be processed by the control for navigation purposes.
OnGotFocus(EventArgs)
Handles the GotFocus event by passing focus to the internal pips pager element.
Select(int)
Selects the pip at the specified index without animation.
Declaration
public void Select(int index)
Parameters
index
The zero-based index of the pip to select
Select(int, bool)
Selects the pip at the specified index with an option to animate the transition.
SelectNext()
Moves the selection to the next pip if possible.
Declaration
public void SelectNext()
SelectPrevious()
Moves the selection to the previous pip 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 pip animation is finished.
Declaration
public event AnimationFinishedEventHandler AnimationFinished
Event Value
AnimationStarted
Occurs when a pip animation is started.
Declaration
public event AnimationStartedEventHandler AnimationStarted
Event Value
CreatePipItem
Occurs when a new pip item is created during the rendering process. This event is suitable for modifying or replacing the pip with custom content or styling.
Declaration
public event CreatePipItemEventHandler CreatePipItem
Event Value
SelectedIndexChanged
Occurs when the selected pip index has changed to a different pip item.
Declaration
public event SelectedPipChangedEventHandler SelectedIndexChanged
Event Value