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.
Inserire un collegamento ipertestuale
Utilizzare il metodo InsertHyperlink per inserire un collegamento ipertestuale nel documento. Questo metodo accetta tre parametri:
- Testo del link da visualizzare nel documento
- Destinazione del collegamento (URL o il nome di un segnalibro all’interno del documento)
- Parametro booleano che dovrebbe essere true se
URL
è un nome di un segnalibro all’interno di un documento
Il metodo InsertHyperlink aggiunge sempre apostrofi all’inizio e alla fine di URL.
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-Java | |
Document doc = new Document(); | |
DocumentBuilder builder = new DocumentBuilder(doc); | |
builder.write("Please make sure to visit "); | |
builder.getFont().setColor(Color.BLUE); | |
builder.getFont().setUnderline(Underline.SINGLE); | |
builder.insertHyperlink("Aspose Website", "http://www.aspose.com", false); | |
builder.getFont().clearFormatting(); | |
builder.write(" for more information."); | |
doc.save(getArtifactsDir() + "AddContentUsingDocumentBuilder.InsertHyperlink.docx"); |
Sostituire o modificare i collegamenti ipertestuali
Il collegamento ipertestuale nei documenti Microsoft Word è un campo. Un campo in un documento di Word, come abbiamo detto in precedenza, è 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.
Per sostituire o modificare i collegamenti ipertestuali, è necessario trovare i collegamenti ipertestuali nel documento e sostituire il loro testo, URLs o entrambi.
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-Java | |
Document doc = new Document(getMyDir() + "Hyperlinks.docx"); | |
for (Field field : doc.getRange().getFields()) | |
{ | |
if (field.getType() == FieldType.FIELD_HYPERLINK) | |
{ | |
FieldHyperlink hyperlink = (FieldHyperlink) field; | |
// Some hyperlinks can be local (links to bookmarks inside the document), ignore these. | |
if (hyperlink.getSubAddress() != null) | |
continue; | |
hyperlink.setAddress("http://www.aspose.com"); | |
hyperlink.setResult("Aspose - The .NET & Java Component Publisher"); | |
} | |
} | |
doc.save(getArtifactsDir() + "WorkingWithFields.ReplaceHyperlinks.docx"); |