Adicionar ou modificar hiperligações

Um hiperlink em Microsoft Word Documentos é o campo HYPERLINK. Em Aspose.Words, os hiperlinks são implementados através da classe FieldHyperlink.

Inserir uma hiperligação

Utilize o método InsertHyperlink para inserir uma hiperligação no documento. Este método Aceita três parâmetros:

1. Texto da ligação a apresentar no documento
2. Destino do Link (URL ou o nome de um marcador dentro do documento)
3. Parâmetro booleano que deve ser verdadeiro se 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 do URL.

Observe que você precisa especificar a formatação da fonte para o texto de exibição do hiperlink explicitamente usando a propriedade 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-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.write("Please make sure to visit ");
builder.getFont().setColor(Color.BLUE);
builder.getFont().setUnderline(Underline.SINGLE);

builder.insertHyperlink("Aspose Website", "http://www.aspose.com", false);

builder.getFont().clearFormatting();
builder.write(" for more information.");

doc.save(getArtifactsDir() + "AddContentUsingDocumentBuilder.InsertHyperlink.docx");

Substituir ou modificar hiperligações

Hiperligação em Microsoft Word documentos é 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 de campo, Código de campo, separador de campo, Resultado de campo e fim de 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 hiperligações, é necessário encontrar as hiperligações no documento e substituir o seu texto, URLs, ou ambos.

O exemplo de código a seguir mostra como encontrar todos os hiperlinks no documento do Word e altera seu URL e nome de exibição:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(getMyDir() + "Hyperlinks.docx");

for (Field field : doc.getRange().getFields())
{
    if (field.getType() == FieldType.FIELD_HYPERLINK)
    {
        FieldHyperlink hyperlink = (FieldHyperlink) field;

        // Some hyperlinks can be local (links to bookmarks inside the document), ignore these.
        if (hyperlink.getSubAddress() != null)
            continue;

        hyperlink.setAddress("http://www.aspose.com");
        hyperlink.setResult("Aspose - The .NET & Java Component Publisher");
    }
}

doc.save(getArtifactsDir() + "WorkingWithFields.ReplaceHyperlinks.docx");