การทำงานกับรายการ
ทำงานกับรายการ
คู่มือนี้แสดงวิธีที่รายการลำดับเลขและรายการหัวข้อถูกแสดงและควบคุมใน Aspose.Words FOSS สำหรับ .NET. List คือการกำหนดรายการที่สามารถใช้งานซ้ำได้และใช้ร่วมกันโดยทุกย่อหน้าที่ใช้มัน, ListFormat คือตัวที่ย่อหน้าต่าง ๆ อ้างอิงถึงรายการและระดับปัจจุบันของมัน, และ ListLevel เก็บรูปแบบการนับเลขหรือหัวข้อจริงสำหรับระดับหนึ่งของรายการ.
อ็อบเจ็กต์รายการและ ListCollection
List แทนการกำหนดรายการหนึ่งรายการ — กฎการนับเลขที่เอกสารสามารถใช้กับหลายย่อหน้า. List.ListId ระบุมัน, List.IsMultiLevel รายงานว่ามันกำหนดมากกว่าหนึ่งระดับหรือไม่, และ List.ListLevels คืนค่า ListLevelCollection ที่เก็บ ListLevel หนึ่งรายการต่อระดับที่รายการกำหนด. List.IsListStyleDefinition และ IsListStyleReference แยกแยะรายการที่กำหนดรูปแบบของตนเองจากรายการที่อ้างอิงรูปแบบผ่าน Style ที่เชื่อมโยง (พร้อมใช้งานผ่าน List.Style). รายการของทุกเอกสารเข้าถึงได้ผ่าน Document.Lists, ซึ่งคืนค่า ListCollection: ListCollection.Add(listTemplate) สร้างรายการใหม่จากหนึ่งในรูปแบบ ListTemplate ที่กำหนดไว้ล่วงหน้าของ Word, Add(listStyle) สร้างรายการจาก Style, AddSingleLevelList(listTemplate) สร้างรูปแบบระดับเดียว, และ AddCopy(srcList) ทำสำเนารายการที่มีอยู่ — มีประโยชน์เมื่อคุณต้องการให้ย่อหน้ามีการนับเลขแบบอิสระ (การเริ่มใหม่) แทนการใช้ตัวนับเดียวกัน. ListCollection.GetListByListId(listId) ดึงรายการเฉพาะ, และ Count รายงานจำนวนรายการที่เอกสารมี.
การใช้รายการกับย่อหน้าด้วย ListFormat
ListFormat ซึ่งเข้าถึงจากรูปแบบของย่อหน้า ควบคุมว่าข้อความย่อหน้านั้นเป็นส่วนของรายการใดและอยู่ระดับใด. ListFormat.List คือ List ที่ย่อหน้าใช้, และ ListFormat.ListLevelNumber คือระดับที่นับจากศูนย์ภายในรายการนั้น; IsListItem รายงานว่ามีย่อหน้าเป็นส่วนของรายการหรือไม่. ApplyBulletDefault() และ ApplyNumberDefault() ใช้รูปแบบรายการหัวข้อหรือเลขเริ่มต้นของ Word กับย่อหน้าในครั้งเดียว, RemoveNumbers() ลบรูปแบบรายการออก, และ ListIndent()/ListOutdent() ย้ายย่อหน้าให้ลึกลงหรือขึ้นระดับในรายการ — การดำเนินการเดียวกับที่ Word ทำเมื่อกด Tab หรือ Shift+Tab ที่จุดเริ่มต้นของย่อหน้ารายการ.
ระดับของรายการและสไตล์การนับเลข
ListLevel เก็บรูปแบบสำหรับระดับหนึ่งของรายการ: NumberStyle (ค่า enum 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 เป็นค่า enum ของรูปแบบรายการที่ Word กำหนดไว้ล่วงหน้า (สไตล์สัญลักษณ์เช่น BulletDefault, BulletDisk, BulletCircle, BulletSquare, BulletDiamonds และรูปแบบตัวเลข), ใช้ร่วมกับ ListCollection.Add(listTemplate) เพื่อเริ่มจากรูปแบบที่มีอยู่ในตัวแทนที่จะสร้างคุณสมบัติทีละอย่าง.
เคล็ดลับและแนวทางปฏิบัติที่ดีที่สุด
- ใช้
ListCollection.AddCopy(srcList)เมื่อกลุ่มย่อหน้าใหม่ต้องการการนับรายการที่เริ่มต้นใหม่อย่างอิสระ, แทนการใช้ซ้ำListที่แนบกับย่อหน้าอื่นแล้ว. - แนะนำให้ใช้
ListFormat.ApplyNumberDefault()/ApplyBulletDefault()สำหรับรายการมาตรฐานแทนการกำหนดค่าListLevelทีละคุณสมบัติด้วยตนเอง. - ตรวจสอบ
List.IsListStyleReferenceกับIsListStyleDefinitionก่อนแก้ไขรูปแบบรายการโดยตรง — รูปแบบของรายการที่อ้างอิงสไตล์อาจถูกควบคุมโดยStyleที่เชื่อมโยงอยู่แทน. - กำหนดค่า
RestartAfterLevelอย่างชัดเจนบนรายการที่ซ้อนกัน แทนการพึ่งพาพฤติกรรมรีสตาร์ทเริ่มต้นเมื่อการนับต้องรีเซ็ตที่ระดับโครงร่างเฉพาะ. - ใช้
ListFormat.ListIndent()/ListOutdent()เพื่อย้ายย่อหน้าระหว่างระดับของรายการแทนการตั้งค่าListLevelNumberโดยตรง เนื่องจากวิธีเหล่านี้ทำให้การจัดรูปแบบรายการของย่อหน้ามีความสอดคล้องภายใน.
ปัญหาที่พบบ่อย
| ปัญหา | สาเหตุ | การแก้ไข |
|---|---|---|
| สองย่อหน้าที่ควรนับแยกกันยังคงต่อเนื่องตามลำดับเดียวกัน | ทั้งสองย่อหน้า ListFormat.List อ้างอิงถึงอ็อบเจ็กต์ List ร่วมเดียวกัน | กำหนดรายการของย่อหน้าที่สองโดยใช้ ListCollection.AddCopy(srcList) แทนการใช้ซ้ำ List |
| สตริงรูปแบบการจัดลำดับเลขที่กำหนดเองไม่แสดงผลตามที่คาดหวัง | ListLevel.NumberFormat ไม่ตรงกับรูปแบบที่คาดไว้สำหรับ NumberStyle ของระดับ | ตรวจสอบให้แน่ใจว่า NumberFormat และ NumberStyle ถูกตั้งค่าอย่างสอดคล้องสำหรับระดับที่กำลังแก้ไข |
| การเยื้องรายการดูผิดพลาดหลังจากเปลี่ยนระดับโดยโปรแกรม | ListLevelNumber ถูกตั้งค่าโดยตรงโดยไม่ได้อัปเดตคุณสมบัติตำแหน่งที่เกี่ยวข้อง | ใช้ ListFormat.ListIndent()/ListOutdent() แทนการตั้งค่า ListLevelNumber โดยตรง |
| จุดสัญลักษณ์รูปภาพไม่ปรากฏ | ไม่ได้สร้างจุดสัญลักษณ์รูปภาพสำหรับระดับนี้ หรือการจัดรูปแบบจุดสัญลักษณ์ข้อความเริ่มต้นยังคงทำงานอยู่ | เรียก 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() | ใช้การจัดรูปแบบหัวข้อแบบจุดหรือแบบลำดับเลขเริ่มต้นกับย่อหน้า |
ListLevel | การจัดรูปแบบลำดับ/หัวข้อสำหรับระดับหนึ่งของ List |
ListLevel.NumberStyle / NumberFormat | สไตล์ตัวเลขและสตริงรูปแบบสำหรับระดับ |
ListLabel | ป้ายกำกับที่แสดงผล (ข้อความและค่า) สำหรับรายการเฉพาะในรายการ |
ListTemplate | Enum ของรูปแบบรายการที่กำหนดล่วงหน้าของ Word |