New to Telerik UI for WinForms? Start a free 30-day trial

Navigates the valid child layout boxes of a container while retaining the currently selected child.

Definition

Namespace:Telerik.WinForms.Documents

Assembly:Telerik.WinControls.RichTextEditor.dll

Syntax:

C#
public class ContainerPositionHandler : PositionHandler

Inheritance: objectPositionHandlerContainerPositionHandler

Derived Classes: ParagraphPositionHandlerTableRowPositionHandlerWordPositionHandler

Inherited Members PositionHandler.Equals(object)PositionHandler.GetHashCode()PositionHandler.Box

Constructors

Initializes a container handler at the specified child layout box.

C#
public ContainerPositionHandler(LayoutBox box, LayoutBox childBox)
Parameters:boxLayoutBox

The container layout box.

childBoxLayoutBox

The child layout box represented by the initial position.

Initializes a container handler without selecting a child layout box.

C#
public ContainerPositionHandler(LayoutBox box)
Parameters:boxLayoutBox

The container layout box.

Fields

The currently selected child layout box.

C#
protected LayoutBox childPosition

Properties

Gets whether this handler can advance to the next position at its navigation level.

C#
public override bool CanMoveToNext { get; }

Overrides: PositionHandler.CanMoveToNext

Gets whether this handler can move to the previous position at its navigation level.

C#
public override bool CanMoveToPrevious { get; }

Overrides: PositionHandler.CanMoveToPrevious

Gets the layout coordinate represented by this position handler.

C#
public override PointF Location { get; }

Overrides: PositionHandler.Location

Methods

Creates a copy of this handler's current navigation state.

C#
public override PositionHandler Clone()
Returns:

PositionHandler

A position handler representing the copied state.

Overrides: PositionHandler.Clone()

Gets a handler for the current child, or selects a valid child when no child is selected.

C#
public virtual PositionHandler GetChildPositionHandler(bool first)
Parameters:firstbool

true to keep the returned handler at its initial position or select the first valid child; false to move it to its last position or select the last valid child.

Returns:

PositionHandler

A handler for the selected child, or null when the container has no valid child position.

Creates a handler for the parent layout box, if one exists.

C#
public override PositionHandler GetParentHandler()
Returns:

PositionHandler

The parent handler, or null when this handler represents the root box.

Overrides: PositionHandler.GetParentHandler()

Moves to the first position represented by this handler.

C#
public override void MoveToFirst()

Overrides: PositionHandler.MoveToFirst()

Moves to the last position represented by this handler.

C#
public override void MoveToLast()

Overrides: PositionHandler.MoveToLast()

Advances to the next position at this handler's navigation level.

C#
public override void MoveToNext()

Overrides: PositionHandler.MoveToNext()

Moves to the previous position at this handler's navigation level.

C#
public override void MoveToPrevious()

Overrides: PositionHandler.MoveToPrevious()

Sets the current child position, advancing to the next valid position when the supplied box is invalid.

C#
public void SetChildPosition(LayoutBox position)
Parameters:positionLayoutBox

The child layout box to use as the current position.