Добавление или изменение гиперссылок
Гиперссылкой в документах Microsoft Word является поле HYPERLINK
. В документе Aspose.Words гиперссылки реализуются с помощью класса FieldHyperlink.
Вставка гиперссылки
Используйте метод insert_hyperlink, чтобы вставить гиперссылку в документ. Этот метод принимает три параметра:
- Текст ссылки, которая будет отображаться в документе
- Место назначения ссылки (URL или название закладки внутри документа)
- Логический параметр, который должен иметь значение true, если
URL
является именем закладки внутри документа
Метод InsertHyperlink всегда добавляет апострофы в начале и конце URL.
Font
.
В следующем примере кода показано, как вставить гиперссылку в документ с помощью DocumentBuilder:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET | |
doc = aw.Document() | |
builder = aw.DocumentBuilder(doc) | |
builder.write("Please make sure to visit ") | |
builder.font.color = drawing.Color.blue | |
builder.font.underline = aw.Underline.SINGLE | |
builder.insert_hyperlink("Aspose Website", "http:#www.aspose.com", False) | |
builder.font.clear_formatting() | |
builder.write(" for more information.") | |
doc.save(docs_base.artifacts_dir + "AddContentUsingDocumentBuilder.insert_hyperlink.docx") |
Заменять или модифицировать гиперссылки
Гиперссылка в документах Microsoft Word - это поле. Поле в документе Word представляет собой сложную структуру, состоящую из нескольких узлов, которые включают начало поля, код поля, разделитель полей, результат поля и конец поля. Поля могут быть вложенными, содержать обширное содержимое и охватывать несколько абзацев или разделов документа.
Чтобы заменить или модифицировать гиперссылки, необходимо найти гиперссылки в документе и заменить либо их текст, либо URLs, либо и то, и другое.
В следующем примере кода показано, как найти все гиперссылки в документе Word и изменить их URL
и отображаемое название:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET | |
doc = aw.Document(docs_base.my_dir + "Hyperlinks.docx") | |
for field in doc.range.fields : | |
if field.type == aw.fields.FieldType.FIELD_HYPERLINK: | |
hyperlink = field.as_field_hyperlink() | |
# Some hyperlinks can be local (links to bookmarks inside the document), ignore these. | |
if hyperlink.sub_address != None : | |
continue | |
hyperlink.address = "http:#www.aspose.com" | |
hyperlink.result = "Aspose - The .net & Java Component Publisher" | |
doc.save(docs_base.artifacts_dir + "WorkingWithFields.replace_hyperlinks.docx") |