คุณสมบัติตัวแสดงสมุดงาน

ภาพรวม

นอกเหนือจากการจัดการไฟล์แล้ว แอปพลิเคชันเดสก์ท็อป Delphi มักต้องแสดงสมุดงานให้ผู้ใช้เห็นเป็นภาพ HotXLS มีตัวควบคุมแบบภาพเพื่อเรนเดอร์แผ่นงานโดยตรงภายในฟอร์ม VCL และ FMX

ตัวควบคุม TXLSWorkbookViewer

คอมโพเนนต์ TXLSWorkbookViewer ให้การเลื่อนดู, การเลือกเป็นสี่เหลี่ยม, การแก้ไข, การป้อนสูตร, คอมเมนต์, ไฮเปอร์ลิงก์, การจัดรูปแบบตามเงื่อนไข และพรีวิวการพิมพ์ โดยไม่สร้างไฟล์ชั่วคราว

กำหนด Workbook สำหรับ classic XLS หรือ XlsxWorkbook สำหรับสมุดงาน XLSX และ ODS หรือเรียก LoadFromFile เพื่อให้ตัวควบคุมเป็นเจ้าของสมุดงานที่โหลดมา

การแก้ไขและการป้อนสูตร

ตั้ง Editable เป็น True เพื่อเปิดการแก้ไขด้วย F2, ดับเบิลคลิก, ปุ่มพิมพ์ได้, Delete และแถบสูตร เซลล์ล็อกที่ถูกป้องกันจะยังอ่านอย่างเดียว ส่วนเซลล์ที่ปลดล็อกแบบชัดเจนยังแก้ไขได้

FormulaBarText คืนสูตรของเซลล์ที่เลือกพร้อมเครื่องหมายเท่ากับนำหน้า หรือค่า input ของมัน การกำหนดพร็อพเพอร์ตี้นี้จะใช้สูตรหรือค่าที่พิมพ์ใหม่และคำนวณสูตรที่ขึ้นต่อกันใหม่

Undo กับ Redo ใช้ประวัติวงแหวนแบบมีขอบเขตที่คุมด้วย UndoLimit การ undo เซลล์ XLSX ที่เพิ่งสร้างจะคืนสู่สถานะ sparse storage แบบไม่มีเซลล์ แต่ละ entry ในประวัติเป็น snapshot TXLSViewerCellState (ชนิดสมุดงาน, การมีอยู่, แผ่นงาน, พิกัด, สูตร, ค่า และสถานะฟอร์แมต) ซึ่งเรียกอ่านได้ผ่านเมธอดอ่านสถานะแบบ public ด้วย

hook ของการแก้ไขเป็น callback แบบมีชนิดข้อมูล: OnBeforeEdit (เป็น TXLSViewerBeforeEditEvent) รับข้อความที่เสนอและยับยั้งหรือเขียนใหม่ได้ผ่าน Allow กับ Text ส่วน OnAfterEdit (เป็น TXLSViewerAfterEditEvent) รายงานข้อความที่ commit แล้ว

Viewer.Editable := True;
Viewer.GoToCell(2, 3);
Viewer.FormulaBarText := '=A1*2';
Viewer.Undo;
Viewer.Redo;

การเลือกช่วงและการอ้างอิง

ใช้การนำทางแบบกด Shift, การลากเมาส์ หรือ SelectRange เพื่อสร้างการเลือกแบบสี่เหลี่ยมที่เปิดเผยผ่าน SelectionTop, SelectionLeft, SelectionBottom, SelectionRight และ SelectedRange

BeginReferencePick เปิดโหมดเลือก reference ของสูตร และ OnReferencePick (เป็น TXLSViewerReferenceEvent) จะเผยแพร่ช่วง A1 ปัจจุบันทุกครั้งที่การเลือกเปลี่ยน เรียก EndReferencePick เมื่อตัวแก้สูตรฝั่งโฮสต์รับ reference แล้ว

คุณสมบัติการแสดงผล

ตรวจสอบตัวควบคุมการกำหนดค่าด้านล่าง

• คู่มืออ้างอิงคอมโพเนนต์ WorkbookViewer — การควบคุมคุณสมบัติเลย์เอาต์
• คุณสมบัติ DisplayGridLines — สลับขอบกริด
• คุณสมบัติ Zoom — ตั้งค่าอัตราส่วนการซูมแผ่นงาน