Aspose.Words for Java での読み込みオプションの使用

Aspose.Words for Java のロードオプションの操作の概要

このチュートリアルでは、Aspose.Words for Java の Load Options の操作方法を説明します。 Load Options を使用すると、ドキュメントの読み込みと処理方法をカスタマイズできます。ダーティフィールドの更新、暗号化されたドキュメントの読み込み、図形の Office Math への変換、MS Word バージョンの設定、一時フォルダーの指定、警告の処理、メタファイルの PNG への変換など、さまざまなシナリオについて説明します。ステップごとに説明しましょう。

ダーティフィールドの更新

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

このコードスニペットは、ドキュメント内のダーティフィールドを更新する方法を示しています。setUpdateDirtyFields(true)このメソッドは、ドキュメントの読み込み中にダーティフィールドが更新されるようにするために使用されます。

暗号化された文書を読み込む

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

ここでは、パスワードを使用して暗号化された文書を読み込みます。LoadOptionsコンストラクタはドキュメントのパスワードを受け入れ、また、ドキュメントを保存するときに新しいパスワードを指定することもできます。OdtSaveOptions.

図形をOffice Mathに変換する

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

このコードは、ドキュメントの読み込み中に図形をOffice Mathオブジェクトに変換する方法を示しています。setConvertShapeToOfficeMath(true)メソッドによりこの変換が可能になります。

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

ドキュメントを読み込むためのMS Wordのバージョンを指定できます。この例では、バージョンをMicrosoft Word 2010に設定しています。setMswVersion.

一時フォルダを使用する

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

一時フォルダを設定することでsetTempFolderドキュメント処理中に一時ファイルが保存される場所を制御できます。

警告コールバック

@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) {
        //ドキュメントの読み込み中に警告が発生した場合は、それを処理します。
        System.out.println(MessageFormat.format("WARNING: {0}, source: {1}", info.getWarningType(), info.getSource()));
        System.out.println(MessageFormat.format("\tDescription: {0}", info.getDescription()));
    }
}

このコードは、ドキュメントの読み込み中に警告を処理するための警告コールバックを設定する方法を示しています。警告が発生したときのアプリケーションの動作をカスタマイズできます。

メタファイルを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);
}

ドキュメントの読み込み中にメタファイル（例：WMF）をPNG画像に変換するには、setConvertMetafilesToPng(true)方法。

Aspose.Words for 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 {
	//新しい LoadOptions オブジェクトを作成します。これは、デフォルトで MS Word 2019 仕様に従ってドキュメントをロードします。
	//読み込みバージョンを 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) {
		//ドキュメントの読み込み中に発生した警告とその詳細を印刷します。
		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);
}

結論

このチュートリアルでは、Aspose.Words for Java のロードオプションの操作に関するさまざまな側面について詳しく説明しました。ロードオプションは、ドキュメントのロードと処理方法をカスタマイズする上で重要な役割を果たし、特定のニーズに合わせてドキュメント処理を調整できます。このガイドで取り上げた重要なポイントをまとめてみましょう。

よくある質問

ドキュメントの読み込み中に警告が発生した場合、どうすれば対処できますか?

警告コールバックは次のように設定できます。warningCallback()上記の方法を使用します。DocumentLoadingWarningCallbackアプリケーションの要件に応じて警告を処理するクラス。

ドキュメントを読み込むときに図形を Office Math オブジェクトに変換できますか?

はい、図形をOffice Mathオブジェクトに変換できます。loadOptions.setConvertShapeToOfficeMath(true).

ドキュメントを読み込むための MS Word のバージョンを指定するにはどうすればよいですか?

使用loadOptions.setMswVersion(MsWordVersion.WORD_2010)ドキュメントを読み込むための MS Word のバージョンを指定します。

の目的は何ですか？`setTempFolder` method in Load Options?

のsetTempFolderメソッドを使用すると、ドキュメント処理中に一時ファイルが保存されるフォルダーを指定できます。

Aspose.Words for Java を使用した HTML ドキュメントの読み込みと保存 Aspose.Words for Java での RTF 読み込みオプションの構成