RadPipsPagerElement
Represents the main element of the RadPipsPager control, providing core functionality for pip-based navigation with animation support, visual layout management, and event handling.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadPipsPagerElement : BaseNavigationElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProviderInheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementBaseNavigationElementRadPipsPagerElement...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadPipsPagerElement class with default settings.
public RadPipsPagerElement()Properties
Gets or sets the number of frames used for pip transition animations.
public override int AnimationFrames { get; set; }Overrides:
Gets or sets the size of the individual pip items displayed in the control.
public Size ItemSize { get; set; }Gets or sets the maximum number of visible pip items displayed in the control at any given time.
public int MaxVisiblePips { get; set; }Gets the pips container element that is responsible for displaying and managing the pip items layout.
public PipsContainer PipsContainer { get; }Methods
Creates and configures the child elements including the pips container and initializes the visible pips display.
protected override void CreateChildElements()Overrides:
Creates and returns the content element that serves as the container for pip items.
protected override LightVisualElement CreateContentElement()A PipsContainer instance that manages the layout and display of pip items
Overrides:
Creates a new instance of the PipsContainer that will manage the pip items layout and animation.
protected virtual PipsContainer CreatePipsContainer()A new PipsContainer instance configured for this pips pager element
Initializes the default field values for the RadPipsPagerElement instance.
protected override void InitializeFields()Overrides:
Handles the completion of animation by clearing non-visible pip items to clean up the display.
protected override void OnAnimationFinished(AnimationStatusEventArgs e)The animation status event arguments
Overrides:
Handles changes to the binding source list by updating the visible pips to reflect the new data state.
protected override void OnBindingSourceListChanged()Overrides:
Raises the CreatePipItem event to allow customization of newly created pip items.
protected virtual void OnCreatePipItem(CreatePipItemEventArgs args)The event arguments containing the pip item that can be customized
Handles changes to the number of pages by updating the visible pips display accordingly.
protected override void OnNumberOfPagesChanged()Overrides:
Raises the SelectedIndexChanged event when the selected pip index changes.
protected virtual void OnSelectedIndexChanged(SelectedPipChangedEventArgs args)The event arguments containing information about the selection change
Removes all existing pip items from the container and creates new visual pip items based on the current state and visible range.
public virtual void ResetVisualPips()Handles the core selection logic including pip creation, animation processing, and event firing when the selected index changes.
Updates the visual pip count, calculates the start index, resets visual pips, and updates the selected index if necessary to maintain consistency.
public virtual void UpdateVisiblePips()Updates the visual items by refreshing the pip display to reflect current state.
protected override void UpdateVisualItems()Overrides:
Events
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.
public event CreatePipItemEventHandler CreatePipItemOccurs when the selected pip index has changed to a different pip item.
public event SelectedPipChangedEventHandler SelectedIndexChanged