Hyperlinks hinzufügen oder ändern

Ein Hyperlink in Microsoft Word -Dokumenten ist das Feld HYPERLINK. In Aspose.Words werden Hyperlinks über die Klasse FieldHyperlink implementiert.

Einfügen eines Hyperlinks

Verwenden Sie die InsertHyperlink-Methode, um einen Hyperlink in das Dokument einzufügen. Diese Methode akzeptiert drei Parameter:

1. Text des Links, der im Dokument angezeigt werden soll
2. Linkziel (URL oder ein Name eines Lesezeichens im Dokument)
3. Boolescher Parameter, der wahr sein sollte, wenn URL ein Name eines Lesezeichens im Dokument ist

Die InsertHyperlink -Methode fügt immer Apostrophe am Anfang und am Ende der URL hinzu.

Beachten Sie, dass Sie die Schriftformatierung für den Hyperlink-Anzeigetext explizit mit der Eigenschaft Font angeben müssen.

Das folgende Codebeispiel zeigt, wie Sie mit DocumentBuilder einen Hyperlink in ein Dokument einfügen:

//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 ersetzen oder ändern

Hyperlink in Microsoft Word -Dokumenten ist ein Feld. Ein Feld in einem Word-Dokument ist eine komplexe Struktur, die aus mehreren Knoten besteht, die Feldanfang, Feldcode, Feldtrennzeichen, Feldergebnis und Feldende enthalten. Felder können verschachtelt sein, umfangreiche Inhalte enthalten und sich über mehrere Absätze oder Abschnitte in einem Dokument erstrecken.

Die Klasse FieldHyperlink implementiert das Feld HYPERLINK.

Das folgende Codebeispiel zeigt, wie Sie alle Hyperlinks im Word-Dokument finden und deren URL und Anzeigenamen ändern:

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