Добавяне или промяна на хипервръзки

Хипервръзка Microsoft Word документите са HYPERLINK Поле. В Aspose.Words, хипервръзките се осъществяват чрез FieldHyperlink Клас.

Вмъкване на хипервръзка

Използвайте InsertHyperlink метод за въвеждане на хипервръзка в документа. Този метод приема три параметъра:

1. Текст на връзката, която ще бъде показана в документа
2. Адрес на връзка (URL или име на отметки вътре в документа)
3. Булев параметър, който трябва да бъде true ако URL е име на отметки в документ

На InsertHyperlink метод винаги добавя apostrophes в началото и края на URL

Имайте предвид, че трябва да зададете форматиране на шрифта за текста на хиперлинк дисплея изрично с помощта на Font собственост.

Следният пример за код показва как да се въведе хипервръзка в документ, като се използва 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");

Замяна или промяна на хипервръзки

Хипервръзка Microsoft Word Документите са поле. Поле в Word документ, както казахме по-рано, е сложна структура, състояща се от множество възли, които включват старт на полето, код на полето, разделител на полето, резултат на полето и край на полето. Полетата могат да бъдат гнездени, да съдържат богато съдържание и да обхващат няколко параграфа или раздели в документ.

За да се заменят или променят хипервръзките, е необходимо да се намерят хипервръзките в документа и да се заменят техните текстове, URL адреси или и двете.

Следният пример за код показва как да намерите всички хипервръзки в Word документа и да промените техните URL и име на дисплея:

// 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");