Gets or sets a value determining whether the frame is treated as a single character or the document's text either flows around or overwrites the frame. If the document's text flows around or overwrites the frame, this property also determines whether the image, text frame, chart, barcode or drawing is moved with the text or fixed positioned on a page.

Syntax

public FrameInsertionMode InsertionMode { get; set; }
Public Property InsertionMode() As FrameInsertionMode

Members

Member Description
AsCharacter The frame is inserted in the text as a single character.
DisplaceCompleteLines The frame is inserted at a certain geometrical location. The text stops at the top and continues at the bottom of the frame.
DisplaceText The frame is inserted at a certain geometrical location. The text flows around the frame and empty areas at the left and right side are filled.
AboveTheText The frame is inserted at a certain geometrical location above the text. This means that the frame overwrites the text.
BelowTheText The frame is inserted at a certain geometrical location below the text. This means that the text overwrites the frame.
MoveWithText The frame is connected with a paragraph and moved with the text.
FixedOnPage The frame is fixed positioned on a page.

The following example shows a FrameBase class with its three properties. The frameBase called "points" is not moveable at runtime and it is fixed positioned on a page.

TXTextControl.FrameBase frameBase = new TXTextControl.FrameBase();

frameBase.Name     = "points";
frameBase.Moveable =  false;
frameBase.InsertionMode = TXTextControl.FrameBase.FrameInsertionMode.FixedOnPage;
Dim frameBase As TXTextControl.FrameBase = New TXTextControl.FrameBase()

frameBase.Name = "points"
frameBase.Moveable =  false
frameBase.InsertionMode = TXTextControl.FrameBase.FrameInsertionMode.FixedOnPage

Remarks

The values of the FrameInsertionMode enumeration can be combined. The following combinations are possible:

DisplaceCompleteLines and MoveWithText

DisplaceCompleteLines and FixedOnPage

DisplaceText and MoveWithText

DisplaceText and FixedOnPage

AboveTheText and MoveWithText

AboveTheText and FixedOnPage

BelowTheText and MoveWithText

BelowTheText and FixedOnPage

AsCharacter

For all other combinations an exception is thrown.

Further Reading

Learn more about the TXTextControl.FrameBase.InsertionMode Property in the Text Control Blog: