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

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

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

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

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

Методът InsertHyperlink винаги добавя апострофи в началото и края на URL.

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

Следващият пример за код показва как да вмъкнете хипервръзка в документ, като използвате DocumentBuilder:

//For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
auto doc = MakeObject<Document>();
auto builder = MakeObject<DocumentBuilder>(doc);

builder->Write(u"Please make sure to visit ");
builder->get_Font()->set_Color(System::Drawing::Color::get_Blue());
builder->get_Font()->set_Underline(Underline::Single);

builder->InsertHyperlink(u"Aspose Website", u"http://www.aspose.com", false);

builder->get_Font()->ClearFormatting();
builder->Write(u" for more information.");

doc->Save(ArtifactsDir + u"AddContentUsingDocumentBuilder.InsertHyperlink.docx");

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

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

Класът FieldHyperlink изпълнява полето HYPERLINK.

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

//For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
auto doc = MakeObject<Document>(MyDir + u"Hyperlinks.docx");

for (const auto& field : System::IterateOver(doc->get_Range()->get_Fields()))
{
    if (field->get_Type() == FieldType::FieldHyperlink)
    {
        auto hyperlink = System::DynamicCast<FieldHyperlink>(field);

        // Some hyperlinks can be local (links to bookmarks inside the document), ignore these.
        if (hyperlink->get_SubAddress() != nullptr)
        {
            continue;
        }

        hyperlink->set_Address(u"http://www.aspose.com");
        hyperlink->set_Result(u"Aspose - The .NET & Java Component Publisher");
    }
}

doc->Save(ArtifactsDir + u"WorkingWithFields.ReplaceHyperlinks.docx");