Hyperlinks toevoegen of wijzigen

Een hyperlink in Microsoft Word documenten is het HYPERLINK veld. In Aspose.Words worden hyperlinks geïmplementeerd via de FieldHyperlink - Klasse.

Een Hyperlink invoegen

Gebruik de methode InsertHyperlink om een hyperlink in het document in te voegen. Deze methode accepteert drie parameters:

1. Tekst van de link die in het document moet worden weergegeven
2. Bestemming koppelen (URL of een naam van een bladwijzer in het document)
3. Booleaanse parameter die waar zou moeten zijn als URL een naam is van een bladwijzer in het document

De InsertHyperlink methode voegt altijd apostrofen toe aan het begin en het einde van de URL.

Merk op dat u de lettertypeopmaak voor de hyperlink-weergavetekst expliciet moet opgeven met behulp van de eigenschap Font.

Het volgende codevoorbeeld laat zien hoe u een hyperlink invoegt in een document met 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");

Hyperlinks vervangen of wijzigen

Hyperlink in Microsoft Word documenten is een veld. Een veld in een Word - document is een complexe structuur die bestaat uit meerdere knooppunten, waaronder veldstart, veldcode, veldscheiding, veldresultaat en veldeinde. Velden kunnen worden genest, rijke inhoud bevatten en meerdere alinea ' s of secties in een document omvatten.

De klasse FieldHyperlink implementeert het veld HYPERLINK.

Het volgende codevoorbeeld toont hoe u alle hyperlinks in Word document kunt vinden en hun URL en weergavenaam kunt wijzigen:

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