Dodawanie lub modyfikowanie hiperłączy

Hiperłącze w dokumentach Microsoft Word to pole HYPERLINK. W Aspose.Words hiperłącza są implementowane przez klasę FieldHyperlink.

Wstawianie hiperłącza

Użyj metody InsertHyperlink, aby wstawić hiperłącze do dokumentu. Ta metoda akceptuje trzy parametry:

1. Tekst linku do wyświetlenia w dokumencie
2. Miejsce docelowe łącza (URL lub nazwa zakładki wewnątrz dokumentu)
3. Parametr logiczny, który powinien być prawdziwy, jeśli URL jest nazwą zakładki wewnątrz dokumentu

Metoda InsertHyperlink zawsze dodaje apostrofy na początku i na końcu URL.

Pamiętaj, że musisz jawnie określić formatowanie czcionki dla tekstu wyświetlania hiperłącza za pomocą właściwości Font.

Poniższy przykład kodu pokazuje, jak wstawić hiperłącze do dokumentu za pomocą 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");

Zastąp lub zmodyfikuj hiperłącza

Hiperłącze w dokumentach Microsoft Word jest polem. Pole w dokumencie Word to złożona struktura składająca się z wielu węzłów, które obejmują początek pola, Kod pola, separator pola, wynik pola i koniec pola. Pola mogą być zagnieżdżone, zawierać bogatą zawartość i obejmować wiele akapitów lub sekcji w dokumencie.

Klasa FieldHyperlink implementuje pole HYPERLINK.

Poniższy przykład kodu pokazuje, jak znaleźć wszystkie hiperłącza w dokumencie Word I zmienić ich URL i nazwę wyświetlaną:

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