previous property

TextBox.previous property

Returns a TextBox that represents the previous TextBox in a sequence of shapes.

@property
def previous(self) -> aspose.words.drawing.TextBox:
    ...

Examples

Shows how to link text boxes.

doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
text_box_shape1 = builder.insert_shape(shape_type=aw.drawing.ShapeType.TEXT_BOX, width=100, height=100)
text_box1 = text_box_shape1.text_box
builder.writeln()
text_box_shape2 = builder.insert_shape(shape_type=aw.drawing.ShapeType.TEXT_BOX, width=100, height=100)
text_box2 = text_box_shape2.text_box
builder.writeln()
text_box_shape3 = builder.insert_shape(shape_type=aw.drawing.ShapeType.TEXT_BOX, width=100, height=100)
text_box3 = text_box_shape3.text_box
builder.writeln()
text_box_shape4 = builder.insert_shape(shape_type=aw.drawing.ShapeType.TEXT_BOX, width=100, height=100)
text_box4 = text_box_shape4.text_box
# Create links between some of the text boxes.
if text_box1.is_valid_link_target(text_box2):
    text_box1.next = text_box2
if text_box2.is_valid_link_target(text_box3):
    text_box2.next = text_box3
# Only an empty text box may have a link.
self.assertTrue(text_box3.is_valid_link_target(text_box4))
builder.move_to(text_box_shape4.last_paragraph)
builder.write('Hello world!')
self.assertFalse(text_box3.is_valid_link_target(text_box4))
if text_box1.next != None and text_box1.previous == None:
    print('This TextBox is the head of the sequence')
if text_box2.next != None and text_box2.previous != None:
    print('This TextBox is the middle of the sequence')
if text_box3.next == None and text_box3.previous != None:
    print('This TextBox is the tail of the sequence')
    # Break the forward link between textBox2 and textBox3, and then verify that they are no longer linked.
    text_box3.previous.break_forward_link()
    self.assertTrue(text_box2.next == None)
    self.assertTrue(text_box3.previous == None)
doc.save(file_name=ARTIFACTS_DIR + 'Shape.CreateLinkBetweenTextBoxes.docx')

previous property

TextBox.previous property

Examples

See Also