การทํางานกับการจัดการตารางกระดาษ

การ Workbook class เป็นจุดเข้าสําหรับการปฏิบัติตารางพจนานุกรมทั้งหมดใน Aspose.Cells FOSS สําหรับ C++ มันให้วิธีในการสร้างหนังสือทํางานใหม่, อัตราบรรจุไฟล์ XLSX ที่มีอยู่, การจัดการใบงาน และบันทึกผลงาน.

การ สร้าง หนังสือ งาน ใหม่

Instantiate Workbook เพื่อสร้างหนังสือทํางานเปล่า. ตารางงานแบบถัดไปจะถูกสร้างโดยอัตโนมัติ.

#include "aspose/cells_foss/Workbook.h"
#include "aspose/cells_foss/Worksheet.h"

using namespace Aspose::Cells_FOSS;

int main() {
    Workbook workbook;
    Worksheet& sheet = workbook.GetWorksheets()[0];
    sheet.SetName("Summary");
    workbook.Save("output.xlsx");
    return 0;
}

การอัตราบรรจุสมุดทํางานที่มีอยู่

ส่งทางไฟล์ไปยัง Workbook constructor เพื่ออัตราบรรจุไฟล์ XLSX ที่มีอยู่ หลังจากการอัสดุ, worksheets และข้อมูลเซลล์ สามารถเข้าถึงได้ทันที.

Workbook workbook("existing.xlsx");
Worksheet& sheet = workbook.GetWorksheets()[0];
// Access or modify cells here
workbook.Save("modified.xlsx");

การตั้งค่า Properties ของ Worksheet

การ Worksheet class เปิดตัวคุณสมบัติการแสดงและความคุ้มครอง ใช้นี้เพื่อตั้งค่าภาพเห็นของแผ่น, การแสดงเครดิต, zoom และสีแท็บ.

Worksheet& sheet = workbook.GetWorksheets()[0];
sheet.SetName("Data");
sheet.SetShowGridlines(false);
sheet.SetShowRowColumnHeaders(true);
sheet.SetZoom(80);

การ ป้องกัน และการ ปล่อย เอกสาร

Call Worksheet::Protect เพื่อล็อคหน้าใบให้ไม่ถูกแก้ไข และ Worksheet::Unprotect เพื่อถอดการคุ้มครอง:

sheet.Protect("password");
// ... distribute the workbook ...
sheet.Unprotect("password");

การรับประกันใบเฉพาะและเขตพื้นที่ชื่อที่กําหนดไว้

เมื่อเพิ่มตารางงานหลายใบโดยโปรแกรม, ใช้ Workbook::EnsureUniqueSheetName เพื่อหลีกเลี่ยงการชนกันของชื่อ. ใช้ Workbook::EnsureValidDefinedNameScope เพื่อยืนยันว่าชื่อที่กําหนดได้ถูกวัดให้เป็นสกอปที่ถูกต้อง.

workbook.EnsureUniqueSheetName();
workbook.EnsureUniqueDefinedName();

การ จัด หนังสือ งาน

Call Workbook::Save(fileName) การเขียนหนังสือทํางานเข้าในดิสก์ การอวอร์โลดหลายครั้งยอมรับชื่อไฟล์, ஸ்ட்รีม หรือการใช้คําแปลที่ชัดเจน SaveFormat.

workbook.Save("products.xlsx");

เคล็ดลับและปฏิบัติที่ดีที่สุด

โทรมาตลอดเลย Workbook::Dispose() เมื่อทํากับหนังสือทํางานเพื่อปล่อยทรัพยากรที่ไม่ได้จัดการ.
ชื่อตารางงานต้องเป็นตัวเลือกในหนังสือทํางาน ใช้ EnsureUniqueSheetName หลังจากการเพิ่มจํานวนชุด.
เซ็ต Worksheet::SetShowGridlines(false) สําหรับใบแบบการแสดง เพื่อปรับปรุงความสามารถในการอ่านได้.
การใช้งาน Worksheet::SetZoom(value) เพื่อกําหนดระดับการขยายขนาดแบบถัดไป (ร้อยละ) สําหรับภาพหน้างาน.
สีแท็บที่ได้รับมอบหมายผ่าน Worksheet::SetTabColor ช่วยผู้ใช้การแยกกระดาษทํางานได้อย่างเห็น.

ปัญหาทั่วไป

Issue	Cause	แก้ไข
ไฟล์ไม่ได้พบเมื่อโหลด	เส้นทางผิดพลาด	ใช้เส้นทางสมบูรณ์ หรือตรวจสอบรายการทํางาน
การชนชื่อใบ	ชื่อซ้ํา ๆ เมื่อเพิ่มใบ	Call `EnsureUniqueSheetName()` หลังจากการเพิ่มทุกครั้ง
การเปลี่ยนแปลงหนังสือทํางานไม่ได้บันทึกไว้	`Save` ไม่เรียก	โทรมาตลอดเลย `workbook.Save(path)` ก่อนออก
การเตือนการรั่วของความจํา	`Dispose` ไม่เรียก	Call `workbook.Dispose()` ในช่วงปลายของเขตใช้งาน

คําอธิบายการพบบ่อย API

ประเภท/วิธีการ	Description
`Workbook()`	สร้างตารางงานเปล่าใหม่
`Workbook(filePath)`	อัตราการอัดไฟล์ XLSX ที่มีอยู่
`Workbook::Save(fileName)`	เก็บหนังสือทํางานในไดสค์
`Workbook::EnsureUniqueSheetName()`	แก้ไขชื่อแผ่นที่ซ้ํากัน
`Workbook::Dispose()`	การปล่อยทรัพยากร
`Worksheet::SetName(name)`	เปลี่ยนชื่อตารางการทํางาน
`Worksheet::SetShowGridlines(bool)`	การเปลี่ยนความเห็นของเส้นเครดิต
`Worksheet::SetZoom(percent)`	กําหนด % ของการขยายแบบตั้งค่า
`Worksheet::Protect(password)`	ปิดตารางการทํางาน
`Worksheet::Unprotect(password)`	เปิดตารางการทํางาน

การทํางานกับการจัดการตารางกระดาษ