การทำงานกับรายการ

ทำงานกับรายการ

คู่มือนี้แสดงวิธีที่รายการลำดับเลขและรายการหัวข้อถูกแสดงและควบคุมใน 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ป้ายกำกับที่แสดงผล (ข้อความและค่า) สำหรับรายการเฉพาะในรายการ
ListTemplateEnum ของรูปแบบรายการที่กำหนดล่วงหน้าของ Word

ดูเพิ่มเติม

 ภาษาไทย