Class

RadPageViewItem

Declaration

protected RadPageViewItem()

Declaration

public static RadProperty AutoFlipMarginProperty

Field Value

Declaration

public static RadProperty ButtonsAlignmentProperty

Field Value

Declaration

public static RadProperty DescriptionProperty

Field Value

Declaration

public static RadProperty IsPinnedProperty

Field Value

Declaration

public static RadProperty IsPreviewProperty

Field Value

Declaration

public static RadProperty IsSelectedProperty

Field Value

Declaration

public static RadProperty TitleProperty

Field Value

Gets or sets a value indicating whether the item margin will be automatically flipped according to the orientation of items in the RadPageView control to maintain proper spacing and alignment.

Declaration

public bool AutoFlipMargin { get; set; }

Property Value

Gets or sets the alignment of the item's associated buttons relative to the item content, controlling the positioning of close and pin buttons within the item layout.

Declaration

public PageViewItemButtonsAlignment ButtonsAlignment { get; set; }

Property Value

Gets the RadPageViewItemButtonsPanel that contains all buttons associated with the item, including close and pin buttons for user interaction.

Declaration

[Browsable(false)]
public RadPageViewItemButtonsPanel ButtonsPanel { get; }

Property Value

Gets or sets the RadElement instance that represents the content of this item. The content is used when the item is not bound to a RadPageViewPage instance.

Declaration

public RadElement Content { get; set; }

Property Value

Gets the current size of the item. This may differ from Bounds.Size as it reflects internal changes within the item itself during layout and measurement operations.

Declaration

[Browsable(false)]
public SizeF CurrentSize { get; }

Property Value

Gets or sets the description of the item. The description is displayed in the footer area of the owning view element. If no description is explicitly set, the Text property value is returned.

Declaration

public string Description { get; set; }

Property Value

Gets the size that is forced by the layout element for this item. This may differ from the DesiredSize when layout constraints or sizing modes override the natural item measurements.

Declaration

[Browsable(false)]
public SizeF ForcedLayoutSize { get; }

Property Value

Gets or sets a value indicating whether the item is pinned. Pinned items appear in front of other items and maintain their position regardless of selection state or other ordering changes.

Declaration

public virtual bool IsPinned { get; set; }

Property Value

Gets or sets a value indicating whether the item is opened for preview, allowing temporary content display without fully selecting the item or changing the current selection state.

Declaration

public virtual bool IsPreview { get; set; }

Property Value

Gets a value indicating whether this item is currently selected (associated with the SelectedPage of the owning RadPageView). Selection affects visual appearance and content display.

Declaration

[Browsable(false)]
public virtual bool IsSelected { get; set; }

Property Value

Gets or sets a value indicating whether the current instance is internally created by the view element and represents built-in functionality rather than user-created content.

Declaration

[Browsable(false)]
public bool IsSystemItem { get; }

Property Value

Gets the RadPageViewElement that owns this item.

Declaration

public virtual RadPageViewElement Owner { get; }

Property Value

Gets the RadPageViewPage instance associated with this item. This page contains the actual content displayed when the item is selected.

Declaration

[Browsable(false)]
public RadPageViewPage Page { get; }

Property Value

Declaration

public int Row { get; set; }

Property Value

Gets or sets the show keyboard cues.

Declaration

public override bool ShowKeyboardCues { get; set; }

Property Value

Overrides LightVisualElement.ShowKeyboardCues

Gets or sets the title of the item. The title is displayed in the header area of the owning view element. If no title is explicitly set, the Text property value is returned.

Declaration

public string Title { get; set; }

Property Value

Gets or sets the use mnemonic.

Declaration

public override bool UseMnemonic { get; set; }

Property Value

Overrides LightVisualElement.UseMnemonic

Arranges all child elements within the client rectangle derived from the final size, ensuring each child element is positioned within the available space.

Declaration

protected override void ArrangeChildren(SizeF available)

Parameters

Overrides RadPageViewElementBase.ArrangeChildren(SizeF)

Attaches this item to the specified RadPageViewPage, establishing a bidirectional relationship and synchronizing visual properties from the page to the item.

Declaration

public virtual void Attach(RadPageViewPage page)

Parameters

Calculates the final measured size by combining content size and child size requirements, taking the maximum width and height from both measurements to ensure all content fits properly.

Declaration

protected override SizeF CalculateMeasuredSize(SizeF contentSize, SizeF childSize)

Parameters

Returns

Overrides RadPageViewElementBase.CalculateMeasuredSize(SizeF, SizeF)

Creates the buttons panel for this page view item, containing close and pin buttons.

Declaration

protected virtual RadPageViewItemButtonsPanel CreateButtonsPanel()

Returns

Creates child elements including the buttons panel and sets up property bindings for close and pin buttons to synchronize with the item's selected and pinned states.

Declaration

protected override void CreateChildElements()

Overrides RadElement.CreateChildElements()

Detaches this item from its associated RadPageViewPage, breaking the bidirectional relationship and clearing page references to prepare for disposal or reassignment.

Declaration

public virtual void Detach()

Disposes of managed resources by detaching from the associated page and clearing owner references to prevent memory leaks and ensure proper cleanup.

Declaration

protected override void DisposeManagedResources()

Overrides LightVisualElement.DisposeManagedResources()

Initializes default field values for the page view item, setting up drag support, sizing constraints, text and image alignment, and keyboard interaction properties.

Declaration

protected override void InitializeFields()

Overrides RadPageViewElementBase.InitializeFields()

Measures the element by calculating the desired size based on content and children, with special handling for vertical orientations where width and height dimensions are swapped in the final measurement.

Declaration

protected override SizeF MeasureOverride(SizeF availableSize)

Parameters

Returns

Overrides RadPageViewElementBase.MeasureOverride(SizeF)

Raises the Click event.

Declaration

protected override void OnClick(EventArgs e)

Parameters

Overrides RadElement.OnClick(EventArgs)

Declaration

protected virtual bool OnContentChanging(RadElement value)

Parameters

Returns

Called when a mouse button is pressed down over the item.

Declaration

protected override void OnMouseDown(MouseEventArgs e)

Parameters

Overrides RadItem.OnMouseDown(MouseEventArgs)

Declaration

protected override void OnMouseEnter(EventArgs e)

Parameters

Overrides RadElement.OnMouseEnter(EventArgs)

Declaration

protected override void OnMouseLeave(EventArgs e)

Parameters

Overrides RadItem.OnMouseLeave(EventArgs)

Called when the mouse moves over the item, handling highlight and border highlight effects.

Declaration

protected override void OnMouseMove(MouseEventArgs e)

Parameters

Overrides LightVisualElement.OnMouseMove(MouseEventArgs)

Called when a mouse button is released over the item.

Declaration

protected override void OnMouseUp(MouseEventArgs e)

Parameters

Overrides RadItem.OnMouseUp(MouseEventArgs)

Handles property change events by invalidating the fill cache and invoking the base class property change handler.

Declaration

protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

Overrides LightVisualElement.OnPropertyChanged(RadPropertyChangedEventArgs)

Notifies that the element has been successfully unloaded from an element tree. Allows inheritors to provide custom logic at this stage.

Declaration

protected override void OnUnloaded(ComponentThemableElementTree oldTree)

Parameters

Overrides RadElement.OnUnloaded(ComponentThemableElementTree)

Paints the element by applying appropriate orientation transforms for fill, content, and border painting, ensuring each painting phase uses the correct coordinate system for proper visual rendering.

Declaration

protected override void PaintElement(IGraphics graphics, float angle, SizeF scale)

Parameters

Overrides RadPageViewElementBase.PaintElement(IGraphics, float, SizeF)

This method is not relevant for this class.

Declaration

public override bool ProcessMnemonic(char charCode)

Parameters

Returns

Overrides RadItem.ProcessMnemonic(char)

Declaration

protected virtual PageViewItemButtonsAlignment RTLTransformButtonsAlignment(PageViewItemButtonsAlignment alignment)

Parameters

Returns

Declaration

protected virtual PageViewItemButtonsAlignment RotateButtonsAlignment(PageViewItemButtonsAlignment alignment)

Parameters

Returns

Declaration

protected virtual Padding RotatePadding(Padding margin)

Parameters

Returns

Sets the bounds of the element to the specified rectangle.

Declaration

protected override void SetBoundsCore(Rectangle bounds)

Parameters

Overrides RadElement.SetBoundsCore(Rectangle)

Declaration

protected virtual void SetContentCore(RadElement value)

Parameters

Sets the content orientation for this element and optionally for all child RadPageViewElementBase elements, invalidating fill cache and measurements when the orientation changes.

Declaration

protected override void SetContentOrientation(PageViewContentOrientation orientation, bool recursive)

Parameters

Overrides RadPageViewElementBase.SetContentOrientation(PageViewContentOrientation, bool)

Gets a value indicating, whether a child will be measured during the MeasureOverride.

Declaration

protected override bool ShouldMeasureChild(RadElement child)

Parameters

Returns

Overrides RadElement.ShouldMeasureChild(RadElement)

Determines whether the specified property should be serialized, with special handling for the AutoEllipsis property to serialize only when it differs from the default value.

Declaration

public override bool? ShouldSerializeProperty(PropertyDescriptor property)

Parameters

Returns

Overrides LightVisualElement.ShouldSerializeProperty(PropertyDescriptor)

Returns a string representation of this page view item including the type name and text content.

Declaration

public override string ToString()

Returns

Overrides RadComponentElement.ToString()