Aspose.Words for Java でリストを使用する

この包括的なチュートリアルでは、Microsoft Word ドキュメントをプログラムで操作するための強力な API である Aspose.Words for Java でリストを効果的に使用する方法について説明します。リストは、ドキュメント内のコンテンツを構造化および整理するために不可欠です。リストの操作に関する 2 つの重要な側面、つまり各セクションでリストを再開することと、リストレベルを指定することについて説明します。さっそく始めましょう。

Aspose.Words for Java の紹介

リストの操作を始める前に、Aspose.Words for Java について理解しましょう。この API は、開発者に Java 環境で Word 文書を作成、変更、操作するためのツールを提供します。これは、単純な文書生成から複雑な書式設定やコンテンツ管理まで、さまざまなタスクに対応する多目的ソリューションです。

環境の設定

まず、開発環境にAspose.Words for Javaがインストールされ、設定されていることを確認してください。ダウンロードできます。ここ.

各セクションでリストを再開する

多くのシナリオでは、ドキュメントの各セクションでリストを再開する必要がある場合があります。これは、レポート、マニュアル、学術論文など、複数のセクションを持つ構造化ドキュメントを作成するときに役立ちます。

Aspose.Words for Java を使用してこれを実現する方法についてのステップバイステップガイドを以下に示します。

ドキュメントを初期化します:

まず、新しいドキュメントオブジェクトを作成します。

Document doc = new Document();

番号付きリストを追加します。

ドキュメントに番号付きリストを追加します。デフォルトの番号付けスタイルを使用します。

doc.getLists().add(ListTemplate.NUMBER_DEFAULT);

リスト設定を構成します。

\各セクションでリストを再開できるようにします。

List list = doc.getLists().get(0);
list.isRestartAtEachSection(true);

DocumentBuilder のセットアップ:

ドキュメントにコンテンツを追加するには、DocumentBuilder を作成します。

DocumentBuilder builder = new DocumentBuilder(doc);
builder.getListFormat().setList(list);

リスト項目を追加:

ループを使用して、ドキュメントにリスト項目を追加します。15 番目の項目の後にセクション区切りを挿入します。

for (int i = 1; i < 45; i++) {
    builder.writeln(MessageFormat.format("List Item {0}", i));
    if (i == 15)
        builder.insertBreak(BreakType.SECTION_BREAK_NEW_PAGE);
}

ドキュメントを保存します:

必要なオプションでドキュメントを保存します。

OoxmlSaveOptions options = new OoxmlSaveOptions();
options.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL);
doc.save(outPath + "RestartListAtEachSection.docx", options);

これらの手順に従うことで、明確で整理されたコンテンツ構造を維持しながら、各セクションで再開されるリストを含むドキュメントを作成できます。

リストレベルの指定

Aspose.Words for Java ではリストレベルを指定できます。これは、ドキュメント内で異なるリスト形式が必要な場合に特に便利です。その方法を見てみましょう。

ドキュメントを初期化します:

新しいドキュメントオブジェクトを作成します。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

番号付きリストを作成する:

Microsoft Word から番号付きリストテンプレートを適用します。

builder.getListFormat().setList(doc.getLists().add(ListTemplate.NUMBER_ARABIC_DOT));

リストレベルを指定します:

さまざまなリストレベルを反復処理してコンテンツを追加します。

for (int i = 0; i < 9; i++) {
    builder.getListFormat().setListLevelNumber(i);
    builder.writeln("Level " + i);
}

箇条書きリストを作成する:

それでは、箇条書きリストを作成しましょう。

builder.getListFormat().setList(doc.getLists().add(ListTemplate.BULLET_DIAMONDS));

箇条書きリストのレベルを指定します:

番号付きリストと同様に、レベルを指定してコンテンツを追加します。

for (int i = 0; i < 9; i++) {
    builder.getListFormat().setListLevelNumber(i);
    builder.writeln("Level " + i);
}

ストップリストのフォーマット:

リストの書式設定を停止するには、リストを null に設定します。

builder.getListFormat().setList(null);

ドキュメントを保存します:

ドキュメントを保存します。

builder.getDocument().save(outPath + "SpecifyListLevel.docx");

これらの手順に従うことで、カスタムリストレベルを持つドキュメントを作成し、ドキュメント内のリストの書式を制御できるようになります。

完全なソースコード

	string outPath = "Your Output Directory";
 public void restartListAtEachSection() throws Exception
    {
        Document doc = new Document();
        doc.getLists().add(ListTemplate.NUMBER_DEFAULT);
        List list = doc.getLists().get(0);
        list.isRestartAtEachSection(true);
        DocumentBuilder builder = new DocumentBuilder(doc);
        builder.getListFormat().setList(list);
        for (int i = 1; i < 45; i++)
        {
            builder.writeln(MessageFormat.format("List Item {0}", i));
            if (i == 15)
                builder.insertBreak(BreakType.SECTION_BREAK_NEW_PAGE);
        }
        // IsRestartAtEachSection は、コンプライアンスが OoxmlComplianceCore.Ecma376 より高い場合にのみ書き込まれます。
        OoxmlSaveOptions options = new OoxmlSaveOptions(); { options.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); }
        doc.save(outPath + "WorkingWithList.RestartListAtEachSection.docx", options);
    }
    @Test
    public void specifyListLevel() throws Exception
    {
        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);
        // Microsoft Wordのリストテンプレートの1つに基づいて番号付きリストを作成します
        //それをドキュメント ビルダーの現在の段落に適用します。
        builder.getListFormat().setList(doc.getLists().add(ListTemplate.NUMBER_ARABIC_DOT));
        //このリストには 9 つのレベルがあります。すべて試してみましょう。
        for (int i = 0; i < 9; i++)
        {
            builder.getListFormat().setListLevelNumber(i);
            builder.writeln("Level " + i);
        }
        // Microsoft Wordのリストテンプレートの1つに基づいて箇条書きリストを作成します
        //それをドキュメント ビルダーの現在の段落に適用します。
        builder.getListFormat().setList(doc.getLists().add(ListTemplate.BULLET_DIAMONDS));
        for (int i = 0; i < 9; i++)
        {
            builder.getListFormat().setListLevelNumber(i);
            builder.writeln("Level " + i);
        }
        //これはリストのフォーマットを停止する方法です。
        builder.getListFormat().setList(null);
        builder.getDocument().save(outPath + "WorkingWithList.SpecifyListLevel.docx");
    }
    @Test
    public void restartListNumber() throws Exception
    {
        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);
        //テンプレートに基づいてリストを作成します。
        List list1 = doc.getLists().add(ListTemplate.NUMBER_ARABIC_PARENTHESIS);
        list1.getListLevels().get(0).getFont().setColor(Color.RED);
        list1.getListLevels().get(0).setAlignment(ListLevelAlignment.RIGHT);
        builder.writeln("List 1 starts below:");
        builder.getListFormat().setList(list1);
        builder.writeln("Item 1");
        builder.writeln("Item 2");
        builder.getListFormat().removeNumbers();
        //最初のリストを再利用するには、元のリストの書式のコピーを作成して番号付けを再開する必要があります。
        List list2 = doc.getLists().addCopy(list1);
        //新しい開始番号の設定を含め、新しいリストを任意の方法で変更できます。
        list2.getListLevels().get(0).setStartAt(10);
        builder.writeln("List 2 starts below:");
        builder.getListFormat().setList(list2);
        builder.writeln("Item 1");
        builder.writeln("Item 2");
        builder.getListFormat().removeNumbers();
        builder.getDocument().save(outPath + "WorkingWithList.RestartListNumber.docx");
	}

結論

おめでとうございます。Aspose.Words for Java でリストを効果的に操作する方法を学習しました。リストは、ドキュメント内のコンテンツを整理して提示するために不可欠です。セクションごとにリストを再開する必要がある場合でも、リストレベルを指定する必要がある場合でも、Aspose.Words for Java には、プロフェッショナルな外観のドキュメントを作成するために必要なツールが用意されています。

これらの機能を使用して、ドキュメントの生成とフォーマットのタスクを強化できます。ご質問やさらなるサポートが必要な場合は、お気軽にお問い合わせください。Aspose コミュニティフォーラムサポートのため。

よくある質問

Aspose.Words for Java をインストールするにはどうすればよいですか?

Aspose.Words for Javaは以下からダウンロードできます。ここドキュメントのインストール手順に従ってください。

リストの番号付け形式をカスタマイズできますか?

はい、Aspose.Words for Java には、リストの番号付け形式をカスタマイズするための広範なオプションが用意されています。詳細については、API ドキュメントを参照してください。

Aspose.Words for Java は最新の Word 文書標準と互換性がありますか?

はい、ISO 29500 を含むさまざまな Word ドキュメント標準に準拠するように Aspose.Words for Java を構成できます。

Aspose.Words for Java を使用して、表や画像を含む複雑なドキュメントを生成できますか?

もちろんです! Aspose.Words for Java は、表や画像などを含む高度なドキュメント書式設定をサポートしています。例についてはドキュメントを確認してください。

Aspose.Words for Java の一時ライセンスはどこで入手できますか?

臨時免許証を取得できますここ.

Aspose.Words for Java でのハイフネーションの使用 Aspose.Words for Java で Markdown を使用する

Aspose.Words for Java でリストを使用する

Aspose.Words for Java の紹介

環境の設定

各セクションでリストを再開する

ドキュメントを初期化します:

番号付きリストを追加します。

リスト設定を構成します。

DocumentBuilder のセットアップ:

リスト項目を追加:

ドキュメントを保存します:

リストレベルの指定

ドキュメントを初期化します:

番号付きリストを作成する:

リスト レベルを指定します:

箇条書きリストを作成する:

箇条書きリストのレベルを指定します:

ストップリストのフォーマット:

ドキュメントを保存します:

完全なソースコード

結論

よくある質問

Aspose.Words for Java をインストールするにはどうすればよいですか?

リストの番号付け形式をカスタマイズできますか?

Aspose.Words for Java は最新の Word 文書標準と互換性がありますか?

Aspose.Words for Java を使用して、表や画像を含む複雑なドキュメントを生成できますか?

Aspose.Words for Java の一時ライセンスはどこで入手できますか?

リストレベルを指定します: