Aspose.Words for Java에서 목록 사용하기

이 포괄적인 튜토리얼에서는 Microsoft Word 문서를 프로그래밍 방식으로 작업하기 위한 강력한 API인 Aspose.Words for Java에서 목록을 효과적으로 사용하는 방법을 살펴보겠습니다. 목록은 문서의 콘텐츠를 구조화하고 구성하는 데 필수적입니다. 목록 작업의 두 가지 주요 측면, 즉 각 섹션에서 목록을 다시 시작하고 목록 수준을 지정하는 방법을 다룹니다. 뛰어들어보자!

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 목록 템플릿 중 하나를 기반으로 번호 매기기 목록 만들기
        //문서 작성기의 현재 단락에 적용합니다.
        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 목록 템플릿 중 하나를 기반으로 글머리 기호 목록 만들기
        //문서 작성기의 현재 단락에 적용합니다.
        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 커뮤니티 포럼 지원을 위해.

자주 묻는 질문

Java용 Aspose.Words를 어떻게 설치하나요?

Java용 Aspose.Words는 다음에서 다운로드할 수 있습니다.여기 설명서의 설치 지침을 따르세요.

목록의 번호 매기기 형식을 사용자 정의할 수 있나요?

예, 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의 임시 라이선스는 어디서 구할 수 있나요?

임시면허를 취득할 수 있습니다.여기.