Utilisation des options de chargement dans Aspose.Words pour Java

Introduction à l’utilisation des options de chargement dans Aspose.Words pour Java

Dans ce didacticiel, nous explorerons comment utiliser les options de chargement dans Aspose.Words pour Java. Les options de chargement vous permettent de personnaliser la manière dont les documents sont chargés et traités. Nous aborderons divers scénarios, notamment la mise à jour des champs modifiés, le chargement de documents cryptés, la conversion de formes en Office Math, la configuration de la version MS Word, la spécification d’un dossier temporaire, la gestion des avertissements et la conversion des métafichiers au format PNG. Allons-y étape par étape.

Mettre à jour les champs sales

LoadOptions loadOptions = new LoadOptions();
loadOptions.setUpdateDirtyFields(true);

Document doc = new Document("Your Directory Path" + "Dirty field.docx", loadOptions);
doc.save("Your Directory Path" + "WorkingWithLoadOptions.UpdateDirtyFields.docx");

Cet extrait de code montre comment mettre à jour les champs modifiés dans un document. LesetUpdateDirtyFields(true) La méthode est utilisée pour garantir que les champs modifiés sont mis à jour lors du chargement du document.

Charger un document crypté

@Test
public void loadEncryptedDocument() throws Exception {
    Document doc = new Document("Your Directory Path" + "Encrypted.docx", new LoadOptions("docPassword"));
    doc.save("Your Directory Path" + "WorkingWithLoadOptions.LoadAndSaveEncryptedOdt.odt", new OdtSaveOptions("newPassword"));
}

Ici, nous chargeons un document crypté à l’aide d’un mot de passe. LeLoadOptions Le constructeur accepte le mot de passe du document et vous pouvez également spécifier un nouveau mot de passe lors de l’enregistrement du document à l’aide deOdtSaveOptions.

Convertir une forme en mathématiques Office

LoadOptions loadOptions = new LoadOptions();
loadOptions.setConvertShapeToOfficeMath(true);

Document doc = new Document("Your Directory Path" + "Office math.docx", loadOptions);
doc.save("Your Directory Path" + "WorkingWithLoadOptions.ConvertShapeToOfficeMath.docx", SaveFormat.DOCX);

Ce code montre comment convertir des formes en objets Office Math lors du chargement du document. LesetConvertShapeToOfficeMath(true)La méthode permet cette conversion.

Définir la version de MS Word

@Test
public void setMsWordVersion() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setMswVersion(MsWordVersion.WORD_2010);

    Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
    doc.save("Your Directory Path" + "WorkingWithLoadOptions.SetMsWordVersion.docx");
}

Vous pouvez spécifier la version MS Word pour le chargement du document. Dans cet exemple, nous définissons la version sur Microsoft Word 2010 en utilisantsetMswVersion.

Utiliser le dossier temporaire

@Test
public void useTempFolder() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setTempFolder("Your Directory Path");

    Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}

En définissant le dossier temporaire à l’aidesetTempFolder, vous pouvez contrôler l’emplacement de stockage des fichiers temporaires pendant le traitement des documents.

Rappel d’avertissement

@Test
public void warningCallback() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setWarningCallback(new DocumentLoadingWarningCallback());

    Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}

public static class DocumentLoadingWarningCallback implements IWarningCallback {
    public void warning(WarningInfo info) {
        // Gérez les avertissements dès qu’ils surviennent lors du chargement du document.
        System.out.println(MessageFormat.format("WARNING: {0}, source: {1}", info.getWarningType(), info.getSource()));
        System.out.println(MessageFormat.format("\tDescription: {0}", info.getDescription()));
    }
}

Ce code montre comment configurer un rappel d’avertissement pour gérer les avertissements lors du chargement du document. Vous pouvez personnaliser le comportement de votre application lorsque des avertissements se produisent.

Convertir des métafichiers en PNG

@Test
public void convertMetafilesToPng() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setConvertMetafilesToPng(true);

    Document doc = new Document("Your Directory Path" + "WMF with image.docx", loadOptions);
}

Pour convertir des métafichiers (par exemple WMF) en images PNG lors du chargement du document, vous pouvez utiliser l’outilsetConvertMetafilesToPng(true) méthode.

Code source complet pour travailler avec les options de chargement dans Aspose.Words pour Java

public void updateDirtyFields() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setUpdateDirtyFields(true);
	}
	Document doc = new Document("Your Directory Path" + "Dirty field.docx", loadOptions);
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.UpdateDirtyFields.docx");
}
@Test
public void loadEncryptedDocument() throws Exception {
	Document doc = new Document("Your Directory Path" + "Encrypted.docx", new LoadOptions("docPassword"));
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.LoadAndSaveEncryptedOdt.odt", new OdtSaveOptions("newPassword"));
}
@Test
public void convertShapeToOfficeMath() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setConvertShapeToOfficeMath(true);
	}
	Document doc = new Document("Your Directory Path" + "Office math.docx", loadOptions);
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.ConvertShapeToOfficeMath.docx", SaveFormat.DOCX);
}
@Test
public void setMsWordVersion() throws Exception {
	// Créez un nouvel objet LoadOptions, qui chargera les documents selon la spécification MS Word 2019 par défaut
	// et changez la version de chargement en Microsoft Word 2010.
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setMswVersion(MsWordVersion.WORD_2010);
	}
	Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.SetMsWordVersion.docx");
}
@Test
public void useTempFolder() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setTempFolder("Your Directory Path");
	}
	Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}
@Test
public void warningCallback() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setWarningCallback(new DocumentLoadingWarningCallback());
	}
	Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}
public static class DocumentLoadingWarningCallback implements IWarningCallback {
	public void warning(WarningInfo info) {
		//Imprime les avertissements et leurs détails au fur et à mesure qu'ils surviennent lors du chargement du document.
		System.out.println(MessageFormat.format("WARNING: {0}, source: {1}", info.getWarningType(), info.getSource()));
		System.out.println(MessageFormat.format("\tDescription: {0}", info.getDescription()));
	}
}
@Test
public void convertMetafilesToPng() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setConvertMetafilesToPng(true);
	}
	Document doc = new Document("Your Directory Path" + "WMF with image.docx", loadOptions);
}
@Test
public void loadChm() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setEncoding(Charset.forName("windows-1251"));
	}
	Document doc = new Document("Your Directory Path" + "HTML help.chm", loadOptions);
}

Conclusion

Dans ce didacticiel, nous avons abordé divers aspects de l’utilisation des options de chargement dans Aspose.Words pour Java. Les options de chargement jouent un rôle crucial dans la personnalisation de la façon dont les documents sont chargés et traités, vous permettant d’adapter le traitement de vos documents à vos besoins spécifiques. Récapitulons les points clés abordés dans ce guide :

FAQ

Comment puis-je gérer les avertissements lors du chargement du document ?

Vous pouvez configurer un rappel d’avertissement comme indiqué dans lewarningCallback() méthode ci-dessus. Personnalisez leDocumentLoadingWarningCallback classe pour gérer les avertissements en fonction des exigences de votre application.

Puis-je convertir des formes en objets Office Math lors du chargement d’un document ?

Oui, vous pouvez convertir des formes en objets Office Math en utilisantloadOptions.setConvertShapeToOfficeMath(true).

Comment puis-je spécifier la version de MS Word pour le chargement des documents ?

UtiliserloadOptions.setMswVersion(MsWordVersion.WORD_2010) pour spécifier la version MS Word pour le chargement du document.

Quel est le but dusetTempFolder method in Load Options?

LesetTempFolderLa méthode vous permet de spécifier le dossier dans lequel les fichiers temporaires sont stockés pendant le traitement du document.