Utilizzo delle proprietà del documento in Aspose.Words per Java

Introduzione alle proprietà del documento

Le proprietà del documento sono una parte vitale di qualsiasi documento. Forniscono informazioni aggiuntive sul documento stesso, come titolo, autore, oggetto, parole chiave e altro. In Aspose.Words per Java, puoi manipolare sia le proprietà del documento integrate che quelle personalizzate.

Enumerazione delle proprietà del documento

Proprietà integrate

Per recuperare e utilizzare le proprietà del documento integrate, puoi utilizzare il seguente snippet di codice:

@Test
public void enumerateProperties() throws Exception
{
    Document doc = new Document("Your Directory Path" + "Properties.docx");
    System.out.println(MessageFormat.format("1. Document name: {0}", doc.getOriginalFileName()));
    System.out.println("2. Built-in Properties");
    for (DocumentProperty prop : doc.getBuiltInDocumentProperties())
        System.out.println(MessageFormat.format("{0} : {1}", prop.getName(), prop.getValue()));
}

Questo codice visualizzerà il nome del documento e le proprietà integrate, incluse proprietà come “Titolo”, “Autore” e “Parole chiave”.

Proprietà personalizzate

Per utilizzare le proprietà personalizzate del documento, puoi utilizzare il seguente snippet di codice:

@Test
public void addCustomDocumentProperties() throws Exception
{
    Document doc = new Document("Your Directory Path" + "Properties.docx");
    CustomDocumentProperties customDocumentProperties = doc.getCustomDocumentProperties();

    if (customDocumentProperties.get("Authorized") != null) return;

    customDocumentProperties.add("Authorized", true);
    customDocumentProperties.add("Authorized By", "John Smith");
    customDocumentProperties.add("Authorized Date", new Date());
    customDocumentProperties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber());
    customDocumentProperties.add("Authorized Amount", 123.45);
}

Questo frammento di codice mostra come aggiungere proprietà personalizzate del documento, tra cui un valore booleano, una stringa, una data, un numero di revisione e un valore numerico.

Rimozione delle proprietà del documento

Per rimuovere proprietà specifiche del documento, è possibile utilizzare il seguente codice:

@Test
public void removeCustomDocumentProperties() throws Exception
{
    Document doc = new Document("Your Directory Path" + "Properties.docx");
    doc.getCustomDocumentProperties().remove("Authorized Date");
}

Questo codice rimuove la proprietà personalizzata “Data autorizzata” dal documento.

Configurazione del collegamento al contenuto

In alcuni casi, potresti voler creare collegamenti all’interno del tuo documento. Ecco come puoi farlo:

@Test
public void configuringLinkToContent() throws Exception
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);
    builder.startBookmark("MyBookmark");
    builder.writeln("Text inside a bookmark.");
    builder.endBookmark("MyBookmark");

    CustomDocumentProperties customProperties = doc.getCustomDocumentProperties();

    // Aggiungi la proprietà collegata al contenuto.
    DocumentProperty customProperty = customProperties.addLinkToContent("Bookmark", "MyBookmark");
    customProperty = customProperties.get("Bookmark");
    boolean isLinkedToContent = customProperty.isLinkToContent();
    String linkSource = customProperty.getLinkSource();
    String customPropertyValue = customProperty.getValue().toString();
}

Questo frammento di codice mostra come creare un segnalibro nel documento e aggiungere una proprietà del documento personalizzata che si collega a quel segnalibro.

Conversione tra unità di misura

In Aspose.Words per Java, puoi convertire facilmente le unità di misura. Ecco un esempio di come farlo:

@Test
public void convertBetweenMeasurementUnits() throws Exception
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);
    PageSetup pageSetup = builder.getPageSetup();

    // Imposta i margini in pollici.
    pageSetup.setTopMargin(ConvertUtil.inchToPoint(1.0));
    pageSetup.setBottomMargin(ConvertUtil.inchToPoint(1.0));
    pageSetup.setLeftMargin(ConvertUtil.inchToPoint(1.5));
    pageSetup.setRightMargin(ConvertUtil.inchToPoint(1.5));
    pageSetup.setHeaderDistance(ConvertUtil.inchToPoint(0.2));
    pageSetup.setFooterDistance(ConvertUtil.inchToPoint(0.2));
}

Questo frammento di codice imposta vari margini e distanze in pollici convertendoli in punti.

Utilizzo dei caratteri di controllo

I caratteri di controllo possono essere utili quando si ha a che fare con il testo. Ecco come sostituire un carattere di controllo nel testo:

@Test
public void useControlCharacters()
{
    final String TEXT = "test\r";

    // Sostituisci il carattere di controllo "\r" con "\r\n".
    String replace = TEXT.replace(ControlChar.CR, ControlChar.CR_LF);
}

In questo esempio, sostituiamo il ritorno a capo (\r) con un ritorno a capo seguito da un avanzamento riga (\r\n).

Conclusione

Le proprietà del documento svolgono un ruolo significativo nella gestione e nell’organizzazione dei documenti in modo efficace in Aspose.Words per Java. Che si tratti di lavorare con proprietà integrate, proprietà personalizzate o utilizzando caratteri di controllo, hai una gamma di strumenti a tua disposizione per migliorare le tue capacità di gestione dei documenti.

Domande frequenti

Come posso accedere alle proprietà del documento integrate?

Per accedere alle proprietà del documento integrate in Aspose.Words per Java, è possibile utilizzare il filegetBuiltInDocumentProperties metodo sulDocument oggetto. Questo metodo restituisce una raccolta di proprietà integrate su cui è possibile scorrere.

Posso aggiungere proprietà di documento personalizzate a un documento?

Sì, puoi aggiungere proprietà di documento personalizzate a un documento utilizzando il fileCustomDocumentProperties collezione. Puoi definire proprietà personalizzate con vari tipi di dati, tra cui stringhe, valori booleani, date e valori numerici.

Come posso rimuovere una proprietà specifica del documento personalizzato?

Per rimuovere una proprietà specifica del documento personalizzato, è possibile utilizzare il fileremove metodo sulCustomDocumentPropertiescollection, passando come parametro il nome della proprietà che si desidera rimuovere.

Qual è lo scopo del collegamento al contenuto di un documento?

Il collegamento al contenuto di un documento consente di creare riferimenti dinamici a parti specifiche del documento. Questo può essere utile per creare documenti interattivi o riferimenti incrociati tra le sezioni.

Come posso convertire tra diverse unità di misura in Aspose.Words per Java?

È possibile convertire tra diverse unità di misura in Aspose.Words per Java utilizzando il fileConvertUtil classe. Fornisce metodi per convertire unità come pollici in punti, punti in centimetri e altro.