Class

RadPageViewNavigationViewItem

Declaration

public RadPageViewNavigationViewItem()

Declaration

public static RadProperty CollapsedGlyphProperty

Field Value

Declaration

public static RadProperty ExpandedGlyphProperty

Field Value

Declaration

public static RadProperty HierarchyIndentProperty

Field Value

Declaration

public static RadProperty IsExpandedProperty

Field Value

Gets or sets the glyph used for the expander element, when the IsExpanded is false.

Declaration

public string CollapsedGlyph { get; set; }

Property Value

Gets or sets the glyph used for the expander element, when the IsExpanded is true.

Declaration

public string ExpandedGlyph { get; set; }

Property Value

Gets the element responsible for expanding and collapsing the item if it has hierarchical children.

Declaration

public LightVisualElement Expander { get; }

Property Value

Gets or sets the hierarchical indentation of the child items.

Declaration

public int HierarchyIndent { get; set; }

Property Value

Determines if the item is expanded assuming it has hierarchical children.

Declaration

public bool IsExpanded { get; set; }

Property Value

Gets the hierarchical level of the item.

Declaration

public int Level { get; }

Property Value

Gets the RadPageViewNavigationViewElement owner of this item.

Declaration

public RadPageViewNavigationViewElement NavigationViewElement { get; }

Property Value

Gets or sets the pin position determining where the item is fixed within the navigation view layout. When set to Header the item is pinned at the top. When set to Footer the item is pinned at the bottom. When set to None the item appears in the normal scrollable area.

Declaration

public NavigationViewItemPinPosition PinPosition { get; set; }

Property Value

Gets the hierarchical popup associated with this item.

Declaration

public virtual RadPopupControlBase Popup { get; }

Property Value

Gets the item layout added to the hierarchical popup.

Declaration

public virtual NavigationViewPopupItemLayout PopupLayout { get; }

Property Value

Arranges the content of the navigation view item with hierarchical indentation based on the item's level. Applies appropriate horizontal offset for nested items and handles RTL layout considerations.

Declaration

protected override void ArrangeContent(SizeF finalSize)

Parameters

Overrides RadPageViewElementBase.ArrangeContent(SizeF)

Arranges the navigation view item elements within the specified final size, positioning the expander element according to RTL settings and available space.

Declaration

protected override SizeF ArrangeOverride(SizeF finalSize)

Parameters

Returns

Overrides RadPageViewStripItem.ArrangeOverride(SizeF)

Attaches the navigation view item to the specified page, configuring expander visibility and subscribing to sub-page collection changes.

Declaration

public override void Attach(RadPageViewPage page)

Parameters

Overrides RadPageViewItem.Attach(RadPageViewPage)

Determines whether the element may be dragged.

Declaration

protected override bool CanDragCore(Point dragStartPoint)

Parameters

Returns

Overrides RadItem.CanDragCore(Point)

Closes any currently shown popup that is different from this item's popup to ensure only one popup is displayed at a time.

Declaration

protected virtual void CloseCurrentlyShownPopup(bool preserveOwnPopup = true)

Parameters

Creates the child elements for the navigation view item including the expander element for hierarchical navigation. Configures the expander with appropriate font, size, alignment, and event handling settings.

Declaration

protected override void CreateChildElements()

Overrides RadPageViewItem.CreateChildElements()

Creates the expander element used for expanding and collapsing hierarchical child items.

Declaration

protected virtual LightVisualElement CreateExpanderElement()

Returns

Creates the popup control used to display hierarchical child items when the navigation view is collapsed. Configures animation settings and layout arrangement for the popup display.

Declaration

protected virtual RadPopupControlBase CreatePopup()

Returns

Creates the popup item layout used to arrange child items within the hierarchical popup.

Declaration

protected virtual NavigationViewPopupItemLayout CreatePopupLayout()

Returns

Detaches the navigation view item from its associated page, unsubscribing from events and cleaning up resources.

Declaration

public override void Detach()

Overrides RadPageViewItem.Detach()

Declaration

protected virtual DropPosition GetDropPosition(Point dropLocation)

Parameters

Returns

Initializes the fields and properties specific to the RadPageViewNavigationViewItem. Configures pin position, drag-drop support, mouse input handling, and layout margins.

Declaration

protected override void InitializeFields()

Overrides RadPageViewItem.InitializeFields()

Handles the enabled state change event and raises UI automation events for accessibility support.

Declaration

protected override void OnEnabledChanged(RadPropertyChangedEventArgs e)

Parameters

Overrides RadItem.OnEnabledChanged(RadPropertyChangedEventArgs)

Raises the KeyDown event.

Declaration

protected override void OnKeyDown(KeyEventArgs e)

Parameters

Overrides RadItem.OnKeyDown(KeyEventArgs)

Handles the loaded event by wiring up necessary event handlers for navigation view functionality.

Declaration

protected override void OnLoaded()

Overrides LightVisualElement.OnLoaded()

Declaration

protected override void OnMouseEnter(EventArgs e)

Parameters

Overrides RadPageViewItem.OnMouseEnter(EventArgs)

Declaration

protected override void OnMouseLeave(EventArgs e)

Parameters

Overrides RadPageViewItem.OnMouseLeave(EventArgs)

Called when a mouse button is released over the item.

Declaration

protected override void OnMouseUp(MouseEventArgs e)

Parameters

Overrides RadPageViewItem.OnMouseUp(MouseEventArgs)

Raises the MouseWheel event.

Declaration

protected override void OnMouseWheel(MouseEventArgs e)

Parameters

Overrides RadElement.OnMouseWheel(MouseEventArgs)

Declaration

protected virtual void OnPinPositionChanged(NavigationViewItemPinPosition oldValue, NavigationViewItemPinPosition newValue)

Parameters

Handles property changed events for expand/collapse state changes and text updates that affect header display.

Declaration

protected override void OnPropertyChanged(RadPropertyChangedEventArgs args)

Parameters

Overrides RadPageViewItem.OnPropertyChanged(RadPropertyChangedEventArgs)

Handles property changing events, specifically managing expand/collapse cancellation through navigation view element events.

Declaration

protected override void OnPropertyChanging(RadPropertyChangingEventArgs args)

Parameters

Overrides RadItem.OnPropertyChanging(RadPropertyChangingEventArgs)

Performs cleanup during disposal, ensuring proper event unwiring and resource cleanup.

Declaration

protected override void PerformDispose(bool disposing)

Parameters

Overrides RadElement.PerformDispose(bool)

Core logic when a drag-drop is performed over this element. Allows inheritors to provide their own implementations.

Declaration

protected override void ProcessDragDrop(Point dropLocation, ISupportDrag dragObject)

Parameters

Overrides RadItem.ProcessDragDrop(Point, ISupportDrag)

Shows the hierarchical popup containing child navigation items when the parent navigation view is collapsed. Configures popup positioning, theming, sizing, and animation settings before displaying.

Declaration

protected virtual void ShowPopup()

Unwires event handlers from the navigation view element and popup control to prevent memory leaks and unwanted callbacks.

Declaration

protected virtual void UnwireEvents()

Wires up event handlers for navigation view element and popup control events to enable proper hierarchical navigation behavior.

Declaration

protected virtual void WireEvents()