리스트 작업

목록 작업

이 가이드는 Aspose.Words FOSS for .NET에서 번호 매기기 및 글머리표 목록이 어떻게 표현되고 제어되는지를 보여줍니다. List은 이를 사용하는 모든 단락이 공유하는 재사용 가능한 목록 정의이며, ListFormat은 개별 단락이 목록 및 현재 수준을 참조하는 방법이고, ListLevel는 목록의 한 수준에 대한 실제 번호 매기기 또는 글머리표 형식을 보유합니다.


목록 객체와 ListCollection

List은 하나의 목록 정의를 나타냅니다 — 문서가 여러 단락에 적용할 수 있는 번호 매기기 규칙입니다. List.ListId은 이를 식별하고, List.IsMultiLevel는 하나 이상의 수준을 정의하는지 여부를 보고하며, List.ListLevels은 목록이 정의하는 각 수준마다 하나의 ListLevel를 보유하는 ListLevelCollection를 반환합니다. List.IsListStyleDefinition와 IsListStyleReference은 자체 형식을 정의하는 목록과 연결된 Style을 통해 형식을 참조하는 목록을 구분합니다 (List.Style을 통해 이용 가능). 모든 문서의 목록은 Document.Lists을 통해 접근할 수 있으며, 이는 ListCollection을 반환합니다: ListCollection.Add(listTemplate)는 Word의 미리 정의된 ListTemplate 형식 중 하나로 새 목록을 만들고, Add(listStyle)는 Style로부터 목록을 만들며, AddSingleLevelList(listTemplate)은 단일 수준 변형을 생성하고, AddCopy(srcList)은 기존 목록을 복제합니다 — 이는 단락이 동일한 카운터를 공유하지 않고 독립적인 번호 매기기(새로운 재시작)를 원할 때 유용합니다. ListCollection.GetListByListId(listId)은 특정 목록을 검색하고, Count는 문서에 있는 목록 수를 보고합니다.

ListFormat를 사용한 단락에 목록 적용

ListFormat은(는) 단락 서식에서 접근할 수 있으며, 단락이 어떤 목록에 속하고 어떤 수준에 있는지를 제어합니다. ListFormat.List은 단락이 사용하는 List이며, ListFormat.ListLevelNumber은 해당 목록 내의 0부터 시작하는 수준입니다; IsListItem는 단락이 목록에 전혀 포함되어 있는지 여부를 보고합니다. ApplyBulletDefault()와 ApplyNumberDefault()은 한 번에 Word의 기본 글머리표 또는 번호 매기기 목록 서식을 단락에 적용하고, RemoveNumbers()은 목록 서식을 제거합니다. ListIndent()/ListOutdent()은 단락을 목록 수준 안으로 더 깊게 혹은 얕게 이동시키며 — 이는 리스트 단락 시작 시 Tab 또는 Shift+Tab을 눌렀을 때 Word가 수행하는 동일한 작업입니다.

목록 수준 및 번호 매기기 스타일

ListLevel은(는) 목록의 한 수준에 대한 서식을 보유합니다: NumberStyle (예: 아라비아 숫자 또는 로마 숫자와 같은 NumberStyle 열거값), NumberFormat (숫자와 마침표 또는 괄호와 같은 문자 텍스트를 결합한 형식 문자열), StartAt (시작 번호), 및 RestartAfterLevel (어떤 상위 수준의 증가가 이 수준의 카운터를 재시작하는지). Alignment (ListLevelAlignment 값: Left, Center, Right) 및 TrailingCharacter (ListTrailingCharacter 값: Tab, Space, Nothing) 은 라벨이 단락 텍스트와 어떻게 위치하고 구분되는지를 제어하며, 정확한 레이아웃을 위해 TabPosition, NumberPosition, TextPosition와 함께 사용됩니다. IsLegal는 법적 스타일 번호 매기기를 강제합니다( NumberStyle와 관계없이 항상 아라비아 숫자). LinkedStyle은(는) 해당 수준을 단락 Style와 연결합니다. 그림 글머리표의 경우, CreatePictureBullet() 및 DeletePictureBullet()가 ImageData 글머리표 이미지를 관리하고, ListLevel.Font은(는) 숫자 또는 글머리표 문자 자체의 서식을 설정합니다. ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat)은(는) 번호 매기기 순서의 특정 위치에서 실제 라벨 값을 계산합니다.

목록 라벨 및 미리 정의된 템플릿

ListLabel은(는) 특정 목록 항목 인스턴스에 대한 렌더링된 라벨을 설명합니다 — LabelString은(는) Word가 표시하는 문자 그대로의 텍스트(예: “3.” 또는 “•")이며, LabelValue은(는) 기본 숫자 값이고, Font은(는) 라벨 서식입니다. ListTemplate은(는) Word의 미리 정의된 목록 형식 열거값(BulletDefault, BulletDisk, BulletCircle, BulletSquare, BulletDiamonds와 같은 글머리표 스타일 및 번호 매기기 형식)이며, ListCollection.Add(listTemplate)과 함께 사용하여 개별 속성을 하나씩 구성하는 대신 내장 형식으로 시작합니다.


팁 및 모범 사례

  • 새로운 단락 그룹이 독립적으로 번호 매기기를 다시 시작해야 할 경우, 이미 다른 단락에 연결된 List을 재사용하는 대신 ListCollection.AddCopy(srcList)을 사용하십시오.
  • 표준 목록에는 모든 ListLevel 속성을 수동으로 설정하는 대신 ListFormat.ApplyNumberDefault() / ApplyBulletDefault()을 사용하는 것이 좋습니다.
  • 목록 서식을 직접 수정하기 전에 List.IsListStyleReference과 IsListStyleDefinition을 확인하십시오 — 스타일을 참조하는 목록의 서식은 대신 연결된 Style에 의해 제어될 수 있습니다.
  • 특정 개요 수준에서 번호 매기기를 재설정해야 할 때 기본 재시작 동작에 의존하지 말고 중첩 목록에 RestartAfterLevel을 명시적으로 설정하십시오.
  • ListFormat.ListIndent()/ListOutdent()을(를) 사용하여 ListLevelNumber를 직접 설정하는 대신 단락을 목록 수준 사이로 이동하십시오. 이러한 방법은 단락의 목록 서식을 내부적으로 일관되게 유지합니다.

일반적인 문제

문제원인해결책
독립적으로 번호가 매겨져야 하는 두 단락이 같은 순서를 계속합니다두 단락의 ListFormat.List가 동일한 공유 List 객체를 가리킵니다두 번째 단락에 동일한 List를 재사용하는 대신 ListCollection.AddCopy(srcList)를 통해 자체 목록을 부여하십시오
사용자 지정 번호 형식 문자열이 예상대로 표시되지 않습니다ListLevel.NumberFormat가 해당 레벨의 NumberStyle에 대한 예상 패턴과 일치하지 않습니다편집 중인 레벨에 대해 NumberFormat와 NumberStyle이 일관되게 설정되었는지 확인하십시오
레벨을 프로그래밍 방식으로 변경한 후 리스트 들여쓰기가 잘못된 것으로 보입니다ListLevelNumber가 관련 위치 속성을 업데이트하지 않고 직접 설정되었습니다ListLevelNumber를 직접 설정하는 대신 ListFormat.ListIndent()/ListOutdent()을 사용하십시오
그림 글머리 기호가 표시되지 않습니다해당 레벨에 그림 글머리 기호가 생성되지 않았거나 기본 텍스트 글머리 기호 서식이 여전히 활성화되어 있습니다텍스트 글머리 기호 서식을 제거하기 전에 ListLevel.CreatePictureBullet()를 호출하고 이미지 데이터를 제공하십시오

FAQ

List와 ListFormat의 차이점은 무엇입니까?

List은(는) 단락 전체에 공유되는 재사용 가능한 번호/글머리 정의이며, ListFormat은(는) 단락별 정의입니다 — 특정 단락이 사용하는 List와 해당 수준을 ListFormat.List 및 ListLevelNumber를 통해 가리킵니다.

단락이 목록의 일부인지 어떻게 확인합니까?

ListFormat.IsListItem을(를) 읽어 단락의 서식을 확인하십시오; true인 경우, ListFormat.List와 ListLevelNumber이(가) 해당 단락이 속한 목록과 수준을 설명합니다.

기존 목록과 독립적으로 새 목록이 1부터 번호 매기기를 시작하도록 하려면 어떻게 해야 합니까?

ListCollection.AddCopy(srcList)을(를) 사용하여 목록 정의의 독립적인 복사본을 만든 다음, 복사본을 새 단락에 적용하세요 — 원래 List을(를) 재사용하면 동일한 카운터가 계속됩니다.

처음부터 글머리표 또는 번호 매긴 목록을 어떻게 만들나요?

ListFormat.ApplyBulletDefault() 또는 ApplyNumberDefault()을(를) 사용하여 Word의 기본 서식을 적용하고, ListCollection.Add(listTemplate)에 ListTemplate 값을 지정하면 Word의 미리 정의된 서식 중 하나에서 시작하여 결과 List.ListLevels를 사용자 지정할 수 있습니다.

“1.” 대신 “1)“과 같은 번호 형식을 어떻게 제어하나요?

관련 수준에 ListLevel.NumberFormat을 원하는 형식 문자열로 설정하고, 숫자 스타일 자체는 NumberStyle으로 설정합니다.


API Reference 요약

클래스/메서드설명
List재사용 가능한 목록(번호 매기기/글머리 기호) 정의
ListCollection문서 내 모든 목록의 모음
ListCollection.Add(listTemplate) / AddCopy(srcList)미리 정의된 템플릿에서 목록을 만들거나 기존 목록을 복사하십시오
ListFormat각 단락마다 List와 현재 레벨에 대한 참조
ListFormat.ApplyBulletDefault() / ApplyNumberDefault()단락에 기본 글머리표 또는 번호 매기기 서식을 적용합니다.
ListLevelList의 한 수준에 대한 번호 매기기/글머리표 서식
ListLevel.NumberStyle / NumberFormat레벨에 대한 숫자 스타일 및 형식 문자열
ListLabel특정 목록 항목에 대한 렌더링된 레이블(텍스트 및 값)
ListTemplateWord의 사전 정의된 목록 형식 열거형

참조

 한국어