Aggiungere o modificare collegamenti ipertestuali

Un collegamento ipertestuale nei documenti Microsoft Word è il campo HYPERLINK. In Aspose.Words, i collegamenti ipertestuali vengono implementati tramite la classe FieldHyperlink.

Inserimento di un collegamento ipertestuale

Utilizzare il metodo InsertHyperlink per inserire un collegamento ipertestuale nel documento. Questo metodo accetta tre parametri:

1. Testo del link da visualizzare nel documento
2. Destinazione del collegamento (URL o nome di un segnalibro all’interno del documento)
3. Parametro booleano che dovrebbe essere true se URL è un nome di un segnalibro all’interno del documento

Il metodo InsertHyperlink aggiunge sempre apostrofi all’inizio e alla fine dell’URL.

Si noti che è necessario specificare la formattazione del carattere per il testo visualizzato collegamento ipertestuale in modo esplicito utilizzando la proprietà Font.

L’esempio di codice seguente mostra come inserire un collegamento ipertestuale in un documento utilizzando 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");

Sostituire o modificare i collegamenti ipertestuali

Il collegamento ipertestuale nei documenti Microsoft Word è un campo. Un campo in un documento Word è una struttura complessa composta da più nodi che includono inizio campo, codice campo, separatore campo, risultato campo e fine campo. I campi possono essere annidati, contenere contenuti ricchi e spaziare più paragrafi o sezioni in un documento.

La classe FieldHyperlink implementa il campo HYPERLINK.

L’esempio di codice seguente mostra come trovare tutti i collegamenti ipertestuali nel documento Word e cambia il loro URL e il nome visualizzato:

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