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.
Insira um hiperlink
Use o método InsertHyperlink 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-.NET | |
Document doc = new Document(); | |
DocumentBuilder builder = new DocumentBuilder(doc); | |
builder.Write("Please make sure to visit "); | |
builder.Font.Color = Color.Blue; | |
builder.Font.Underline = Underline.Single; | |
builder.InsertHyperlink("Aspose Website", "http://www.aspose.com", false); | |
builder.Font.ClearFormatting(); | |
builder.Write(" for more information."); | |
doc.Save(ArtifactsDir + "AddContentUsingDocumentBuilder.InsertHyperlink.docx"); |
Substitua ou modifique hiperlinks
O hiperlink em documentos Microsoft Word é um campo. Um campo em um documento do Word, como dissemos anteriormente, é 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-.NET | |
Document doc = new Document(MyDir + "Hyperlinks.docx"); | |
foreach (Field field in doc.Range.Fields) | |
{ | |
if (field.Type == FieldType.FieldHyperlink) | |
{ | |
FieldHyperlink hyperlink = (FieldHyperlink) field; | |
// Some hyperlinks can be local (links to bookmarks inside the document), ignore these. | |
if (hyperlink.SubAddress != null) | |
continue; | |
hyperlink.Address = "http://www.aspose.com"; | |
hyperlink.Result = "Aspose - The .NET & Java Component Publisher"; | |
} | |
} | |
doc.Save(ArtifactsDir + "WorkingWithFields.ReplaceHyperlinks.docx"); |