location property

FieldGoToButton.location property

Gets or sets the name of a bookmark, a page number, or some other item to jump to.

@property
def location(self) -> str:
    ...

@location.setter
def location(self, value: str):
    ...

Examples

Shows to insert a GOTOBUTTON field.

doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# Add a GOTOBUTTON field. When we double-click this field in Microsoft Word,
# it will take the text cursor to the bookmark whose name the Location property references.
field = builder.insert_field(field_type=aw.fields.FieldType.FIELD_GO_TO_BUTTON, update_field=True).as_field_go_to_button()
field.display_text = 'My Button'
field.location = 'MyBookmark'
self.assertEqual(' GOTOBUTTON  MyBookmark My Button', field.get_field_code())
# Insert a valid bookmark for the field to reference.
builder.insert_break(aw.BreakType.PAGE_BREAK)
builder.start_bookmark(field.location)
builder.writeln('Bookmark text contents.')
builder.end_bookmark(field.location)
doc.update_fields()
doc.save(file_name=ARTIFACTS_DIR + 'Field.GOTOBUTTON.docx')

See Also

FieldGoToButton.display_text property