العمل مع إدارة Spreadsheet

المجلس الوزاري Workbook class هي نقطة الدخول لجميع عمليات الجدول في Aspose.Cells FOSS for C++. توفر طرقًا لإنشاء كتب عمل جديدة، وتحميل ملفات XLSX الموجودة، وإدارة ورق العمل ، وحفظ النتيجة.

إنشاء دفتر عمل جديد

التثبيت 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 إنشاء ملف XLSX موجود. بعد التحميل، يتم الوصول إلى ورق العمل وبيانات الخلية على الفور.

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

تهيئة خصائص ورقة العمل

المجلس الوزاري Worksheet تستخدم هذه لتكوين رؤية الصفحة، عرض الشبكة، التكبير، ولون علامة تبويب.

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

حماية ورقة عمل أو إزالتها

اتصلوا Worksheet::Protect لتحديد صفحة ضد التعديلات، و Worksheet::Unprotect لإزالة الحماية:

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

ضمان ورقة فريدة ومدى الاسم المحدد

عند إضافة أوراق عمل متعددة برمجياً، استخدم: Workbook::EnsureUniqueSheetName لتجنب اصطدامات الأسماء. استخدام Workbook::EnsureValidDefinedNameScope للتحقق من أن الأسماء المحددة هي المنطقة بشكل صحيح.

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

حفظ دفتر عمل

اتصلوا Workbook::Save(fileName) للكتابة إلى القرص. إعادة تحميل متعددة تقبل اسم الملف، أو تيار، او صريح SaveFormat.

workbook.Save("products.xlsx");

نصائح وأفضل الممارسات

دائماً اتصل Workbook::Dispose() عندما يتم مع دفتر عمل لإطلاق الموارد غير المدارة.
يجب أن تكون أسماء ورق العمل فريدة من نوعها في كتاب عمل استخدام EnsureUniqueSheetName بعد إضافة المجموعات.
المجموعة Worksheet::SetShowGridlines(false) لصفحات نمط العرض لتعزيز قابلية القراءة.
استخدام Worksheet::SetZoom(value) لتحديد مستوى التكبير الافتراضي (بالنسبة المئوية) لمشاهد ورقة العمل.
ألوان علامة التبويب المخصصة عبر Worksheet::SetTabColor مساعدة المستخدمين على التمييز بين ورق العمل بصرياً.

القضايا المشتركة

القضية	السبب	إصلاح
لم يتم العثور على الملف عند التحميل	مسار غير صحيح	استخدام المسار المطلق أو التحقق من الدليل العامل
تصادم اسم الصفحة	أسماء متكررة عند إضافة الصفحات	اتصلوا `EnsureUniqueSheetName()` بعد كل إضافة
التغييرات في دفتر العمل غير محفوظة	`Save` غير مدعو	دائماً اتصل `workbook.Save(path)` قبل الخروج
تحذيرات تسرب الذاكرة	`Dispose` غير مدعو	اتصلوا `workbook.Dispose()` في نهاية نطاق التطبيق

إشارة API

الفئة/الطريقة	وصف
`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)`	يفتح ورقة العمل

العمل مع إدارة Spreadsheet