Working with TextBoxes

In Aspose.Words, the TextBox class is used to specify how text is displayed inside a shape. It exposes a public property named Parent to get the parent shape for the text box so that the customer can find the linked Shape from the associated TextBox.

Creating a Link

The TextBox class provides IsValidLinkTarget method in order to check whether the TextBox can be linked to the target Textbox.

The following code example shows how to check if the TextBox can be linked to the target Textbox:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();

Shape shape1 = new Shape(doc, ShapeType.TextBox);
Shape shape2 = new Shape(doc, ShapeType.TextBox);

TextBox textBox1 = shape1.TextBox;
TextBox textBox2 = shape2.TextBox;

if (textBox1.IsValidLinkTarget(textBox2))
    textBox1.Next = textBox2;

Check TextBox Sequence

There are several ways to display text in a shape. The TextBox can be the Head, Middle, or Tail of a sequence.

The following code example shows how to check if TextBox is a Head, Tail, or Middle of the sequence:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();

Shape shape = new Shape(doc, ShapeType.TextBox);
TextBox textBox = shape.TextBox;

if (textBox.Next != null && textBox.Previous == null)
    Console.WriteLine("The head of the sequence");

if (textBox.Next != null && textBox.Previous != null)
    Console.WriteLine("The Middle of the sequence.");

if (textBox.Next == null && textBox.Previous != null)
    Console.WriteLine("The Tail of the sequence.");

Breaking a Link

Using the BreakForwardLink method you can break the link to the next TextBox.

The following code example shows how to break a link for a TextBox:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();

Shape shape = new Shape(doc, ShapeType.TextBox);
TextBox textBox = shape.TextBox;

// Break a forward link.
textBox.BreakForwardLink();

// Break a forward link by setting a null.
textBox.Next = null;

// Break a link, which leads to this textbox.
textBox.Previous?.BreakForwardLink();