Adicionar ou modificar hiperlinks
Um hiperlink em documentos Microsoft Word é o campo HYPERLINK
. Em Aspose.Words, os hiperlinks são implementados por meio da classe FieldHyperlink.
Inserindo um hiperlink
Use o método insert_hyperlink para inserir um hiperlink no documento. Este método aceita três parâmetros:
- Texto do link a ser exibido no documento
- Destino do link (URL ou nome de um favorito dentro do documento)
- Parâmetro booleano que deve ser true se o
URL
for o nome de um marcador dentro de um documento
O método InsertHyperlink sempre adiciona apóstrofos no início e no final da URL.
Font
.
O exemplo de código a seguir mostra como inserir um hiperlink em um documento usando 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") |
Substitua ou modifique hiperlinks
O hiperlink em documentos Microsoft Word é um campo. Um campo em um documento do Word é uma estrutura complexa que consiste em vários nós que incluem início do campo, código do campo, separador de campo, resultado do campo e final do campo. Os campos podem ser aninhados, conter conteúdo rico e abranger vários parágrafos ou seções em um documento
Para substituir ou modificar hiperlinks, é necessário localizar os hiperlinks no documento e substituir seu texto, URLs ou ambos.
O exemplo de código a seguir mostra como localizar todos os hiperlinks em um documento do Word e alterar seu URL
e nome de exibição:
# 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") |