Lays out page items along one edge of the view and supports strip scrolling, item buttons, and an optional new-page item.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadPageViewStripElement : RadPageViewElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementRadPageViewElementBaseRadPageViewElementRadPageViewStripElement...
Derived Classes:
Implements:
Inherited Members
Constructors
Creates a strip-style page-view element.
public RadPageViewStripElement()
Fields
Identifies AnimatedStripScrolling, which enables or disables animated strip scrolling.
public static RadProperty AnimatedStripScrollingProperty
Identifies ItemAlignment, which aligns items within the strip layout.
public static RadProperty ItemAlignmentProperty
Identifies ItemFitMode, which controls how strip items fit the available layout space.
public static RadProperty ItemFitModeProperty
Identifies NewItemVisibility, which places or hides the internal new-page item.
public static RadProperty NewItemVisibilityProperty
Identifies ShowItemPinButton, which controls whether strip items display a pin button.
public static RadProperty ShowItemPinButtonProperty
Identifies StripAlignment, which positions the strip relative to the page content.
public static RadProperty StripAlignmentProperty
Identifies StripButtons, which selects the navigation and item buttons available on the strip.
public static RadProperty StripButtonsProperty
Identifies StripScrollingAnimation, which selects the easing used for strip scrolling.
public static RadProperty StripScrollingAnimationProperty
Properties
Determines whether strip scrolling will be animated.
public virtual bool AnimatedStripScrolling { get; set; }
Determines the alignment of items within the strip layout.
public StripViewItemAlignment ItemAlignment { get; set; }
Gets the container that holds item layout and strip buttons panel.
[Browsable(false)]
public StripViewItemContainer ItemContainer { get; }
Determines the fit mode to be applied when measuring child items.
public StripViewItemFitMode ItemFitMode { get; set; }
Gets the strip item layout that parents page items in the visual tree.
protected override RadElement ItemsParent { get; }
Overrides:
Gets or sets how multi-line strip items respond when the view is resized. The value is forwarded to the internal item layout.
public virtual MultiLineItemFitMode MultiLineItemFitMode { get; set; }
Gets the RadPageViewStripItem which stands for adding new pages on click.
[Browsable(false)]
public RadPageViewStripItem NewItem { get; }
Gets or sets the visibility of the internal NewItem.
public virtual StripViewNewItemVisibility NewItemVisibility { get; set; }
Gets or sets the item of the page which is opened for preview on the far side of the regular items.
[Browsable(false)]
public virtual RadPageViewItem PreviewItem { get; set; }
Determines if the PinButton will be displayed in each item, allowing that item to be pinned.
public virtual bool ShowItemPinButton { get; set; }
Gets or sets the alignment of item strip within the view.
public virtual StripViewAlignment StripAlignment { get; set; }
Determines scroll buttons' visibility.
public virtual StripViewButtons StripButtons { get; set; }
Gets or sets the easing type of the strip scroll animation.
public virtual RadEasingType StripScrollingAnimation { get; set; }
Methods
Adds the item and repositions the internal new-page item at the configured end or front of the strip.
protected override void AddItemCore(RadPageViewItem item)
The strip item being added.
Overrides:
Arranges the strip along its configured edge and returns the remaining rectangle for page content.
protected override RectangleF ArrangeItems(RectangleF itemsRect)
The rectangle available for the strip and content area.
Returns:The rectangle remaining for page content.
Overrides:
Prevents dropping an item onto the internal new-page item.
protected override bool CanDropOverItem(RadPageViewItem dragItem, RadPageViewItem hitItem)
The item being dragged.
hitItemRadPageViewItemThe item under the pointer.
Returns:false for the new-page item; otherwise, the base view's drop decision.
Overrides:
Ignores close requests for the internal new-page item and delegates other items to the base view.
protected override void CloseItem(RadPageViewItem item)
The item to close.
Overrides:
Creates the item container and the internal item used to request a new page before creating the remaining child elements.
protected override void CreateChildElements()
Overrides:
Creates a tab item for this strip view.
Creates the container that hosts strip items and their navigation buttons. Override this method to supply a specialized item container.
Disposes the internal new-page item before releasing the base view's managed resources.
protected override void DisposeManagedResources()
Overrides:
Restores the configured strip-scrolling animation after an item drag ends.
protected override void EndItemDrag(RadPageViewItem item)
The item whose drag has ended.
Overrides:
Scrolls the strip as needed to bring the specified item into view.
protected override bool EnsureItemVisibleCore(RadPageViewItem item)
The strip item to reveal.
Returns:true if the layout ensures that the item is visible.
Overrides:
Chooses item or content orientation from the strip alignment.
protected override PageViewContentOrientation GetAutomaticItemOrientation(bool content)
Whether the orientation is being calculated for page content rather than a strip item.
Returns:The orientation appropriate for the current strip alignment.
Overrides:
Gets the bounds of the strip's item layout, excluding the page content area.
Returns the peek-popup arrow direction corresponding to the strip's edge.
protected override ArrowDirection GetPeekPopupArrowDirection()
The direction in which the popup arrow points.
Overrides:
Identifies the strip button whose bounds contain the specified control-client point.
Determines whether a child is external to the strip's internal item container and new-page item.
protected override bool IsChildElementExternal(RadElement element)
The child element to test.
Returns:true when the element is treated as external by this view or its base.
Overrides:
Measures the strip and content area, reserving space for the strip along its configured edge.
Processes the item click and raises the new-page request when the internal new-page item was clicked.
protected override void OnItemClick(RadPageViewItem sender, EventArgs e)
The item that was clicked.
eEventArgsThe event data.
Overrides:
Leaves the internal new-page item out of the normal item mouse-down processing.
protected override void OnItemMouseDown(RadPageViewItem sender, MouseEventArgs e)
The item receiving the mouse input.
eMouseEventArgsThe mouse event data.
Overrides:
Raises NewPageRequested on the owning page view, when one is assigned.
protected virtual void OnNewItemRequested()
Updates item orientation, strip placement, scrolling, button visibility, and new-item placement when related properties change.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
The property-change event data.
Overrides:
Stops an active strip-scroll animation before changing the selected item.
protected override void SetSelectedItem(RadPageViewItem item)
The item to select.
Overrides:
Disables animated scrolling while an item is being dragged.
protected override void StartItemDrag(RadPageViewItem item)
The item being dragged.
Overrides:
Updates the orientation of the supplied items and the internal new-page item.
protected override void UpdateItemOrientation(IEnumerable items)
The strip items whose orientation is being updated.
Overrides: