Utilisation des propriétés du document dans Aspose.Words pour Java

Introduction aux propriétés du document

Les propriétés du document sont une partie essentielle de tout document. Ils fournissent des informations supplémentaires sur le document lui-même, telles que son titre, son auteur, son sujet, ses mots-clés, etc. Dans Aspose.Words pour Java, vous pouvez manipuler les propriétés de document intégrées et personnalisées.

Énumération des propriétés du document

Propriétés intégrées

Pour récupérer et utiliser les propriétés de document intégrées, vous pouvez utiliser l’extrait de code suivant :

@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()));
}

Ce code affichera le nom du document et les propriétés intégrées, y compris des propriétés telles que “Titre”, “Auteur” et “Mots clés”.

Propriétés personnalisées

Pour utiliser les propriétés de document personnalisées, vous pouvez utiliser l’extrait de code suivant :

@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);
}

Cet extrait de code montre comment ajouter des propriétés de document personnalisées, notamment une valeur booléenne, une chaîne, une date, un numéro de révision et une valeur numérique.

Suppression des propriétés du document

Pour supprimer des propriétés de document spécifiques, vous pouvez utiliser le code suivant :

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

Ce code supprime la propriété personnalisée « Date autorisée » du document.

Configuration du lien vers le contenu

Dans certains cas, vous souhaiterez peut-être créer des liens dans votre document. Voici comment procéder :

@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();

    // Ajouter un lien vers la propriété de contenu.
    DocumentProperty customProperty = customProperties.addLinkToContent("Bookmark", "MyBookmark");
    customProperty = customProperties.get("Bookmark");
    boolean isLinkedToContent = customProperty.isLinkToContent();
    String linkSource = customProperty.getLinkSource();
    String customPropertyValue = customProperty.getValue().toString();
}

Cet extrait de code montre comment créer un signet dans votre document et ajouter une propriété de document personnalisée qui renvoie à ce signet.

Conversion entre unités de mesure

Dans Aspose.Words pour Java, vous pouvez facilement convertir les unités de mesure. Voici un exemple de la façon de procéder :

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

    // Définissez les marges en pouces.
    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));
}

Cet extrait de code définit diverses marges et distances en pouces en les convertissant en points.

Utiliser des caractères de contrôle

Les caractères de contrôle peuvent être utiles lorsqu’il s’agit de texte. Voici comment remplacer un caractère de contrôle dans votre texte :

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

    // Remplacez le caractère de contrôle "\r" par "\r\n".
    String replace = TEXT.replace(ControlChar.CR, ControlChar.CR_LF);
}

Dans cet exemple, nous remplaçons le retour chariot (\r) avec un retour chariot suivi d’un saut de ligne (\r\n).

Conclusion

Les propriétés du document jouent un rôle important dans la gestion et l’organisation efficace de vos documents dans Aspose.Words pour Java. Qu’il s’agisse de travailler avec des propriétés intégrées, des propriétés personnalisées ou d’utiliser des caractères de contrôle, vous disposez d’une gamme d’outils pour améliorer vos capacités de gestion de documents.

FAQ

Comment accéder aux propriétés intégrées du document ?

Pour accéder aux propriétés de document intégrées dans Aspose.Words pour Java, vous pouvez utiliser legetBuiltInDocumentProperties méthode sur leDocument objet. Cette méthode renvoie une collection de propriétés intégrées que vous pouvez parcourir.

Puis-je ajouter des propriétés de document personnalisées à un document ?

Oui, vous pouvez ajouter des propriétés de document personnalisées à un document à l’aide de l’outilCustomDocumentProperties collection. Vous pouvez définir des propriétés personnalisées avec différents types de données, notamment des chaînes, des booléens, des dates et des valeurs numériques.

Comment puis-je supprimer une propriété de document personnalisée spécifique ?

Pour supprimer une propriété de document personnalisée spécifique, vous pouvez utiliser l’outilremove méthode sur leCustomDocumentPropertiescollection, en passant le nom de la propriété que vous souhaitez supprimer en tant que paramètre.

Quel est le but d’un lien vers le contenu d’un document ?

Créer des liens vers le contenu d’un document vous permet de créer des références dynamiques à des parties spécifiques du document. Cela peut être utile pour créer des documents interactifs ou des références croisées entre sections.

Comment puis-je convertir entre différentes unités de mesure dans Aspose.Words pour Java ?

Vous pouvez convertir entre différentes unités de mesure dans Aspose.Words for Java en utilisant leConvertUtil classe. Il fournit des méthodes pour convertir des unités telles que les pouces en points, les points en centimètres, etc.