العمل مع إدارة Spreadsheet
إدارة أوراق العمل
المجلس الوزاري WorksheetCollection يقدم الفصل طرق لإدارة ورق العمل داخل دفتر عمل. إضافة أوراق عمل جديدة مع addWorksheet(), إزالة مع removeWorksheet(),، وإعادة ترتيب مع moveWorksheet().
import { Workbook } from "@aspose/cells";
const workbook = new Workbook();
const sheets = workbook.worksheets;
const sheet2 = sheets.addWorksheet("Sales");
const sheet3 = sheets.addWorksheet("Summary");
sheet2.putValue("A1", "Sales Data");
sheet3.putValue("A1", "Summary Report");
await workbook.save("multi-sheet.xlsx");قيم الخلية والصيغ
اكتب الأعداد الصحيحة، العشرية والسلسلات مع worksheet.putValue(). الخلايا الوصولية بالمرجع مع getCell2() أو حسب مؤشر الصفوف/العمدة مع: getCell(). وضع صيغ مع: cell.setFormula().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", 42);
worksheet.putValue("A2", 3.14159);
worksheet.putValue("A3", "Hello World");
const cellA4 = worksheet.getCell2("A4");
cellA4.setFormula("=SUM(A1:A2)");
await workbook.save("values.xlsx");تصميم الخط والملء
تطبيق إعدادات الخط باستخدام النمط: Style class. حدد اسم الخط، الحجم، الشجاعة، التالي واللون. تطبيق النمط على الخلايا الفردية مع cell.setStyle().
import { Workbook, Style } from "@aspose/cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
const style = new Style();
style.setFontName("Arial");
style.setFontSize(14);
style.setBold(true);
style.setItalic(true);
style.setFontColor("FF0000");
const cell = worksheet.getCell2("A1");
cell.putValue("Styled Text");
cell.setStyle(style);
await workbook.save("styled.xlsx");بيانات التحقق
إضافة قواعد التحقق من صحة إلى نطاقات الخلايا باستخدام: DataValidation.حدد نوع التحقق من صحة المعلومات (القائمة، نطاق الأرقام أو الإصدارات) واستعمل مع: worksheet.addDataValidation().
import { Workbook, DataValidation } from "@aspose/cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
const validation = new DataValidation();
validation.type = "list";
validation.formula1 = '"Option1,Option2,Option3"';
worksheet.addDataValidation(validation, "B1:B10");
await workbook.save("validated.xlsx");الفلتر السيارات
تمكين رؤوس الأعمدة القابلة للتصفية مع: worksheet.setAutoFilter().إزالة المرشحات مع worksheet.removeAutoFilter().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Name");
worksheet.putValue("B1", "Age");
worksheet.putValue("C1", "City");
worksheet.putValue("A2", "Alice");
worksheet.putValue("B2", "25");
worksheet.putValue("C2", "New York");
worksheet.setAutoFilter("A1:C4");
await workbook.save("filtered.xlsx");روابط فوق الصفحة
إرفاق روابط إلى الخلايا مع: cell.setHyperlink().يدعم عناوين URL وعناوين البريد الإلكتروني ومراجع الصفحة الداخلية.
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Click here");
worksheet.getCell2("A1").setHyperlink("https://www.example.com");
worksheet.putValue("A3", "Send email");
worksheet.getCell2("A3").setHyperlink("mailto:test@example.com");
await workbook.save("hyperlinks.xlsx");حماية دفتر العمل
حماية الكتب العاملة بكلمة مرور باستخدام: workbook.protect().قفل الخلايا الفردية مع style.setLocked(true).
import { Workbook, Style } from "@aspose/cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Protected Cell");
const style = new Style();
style.setLocked(true);
worksheet.getCell2("A1").setStyle(style);
workbook.protect(true, "password");
await workbook.save("protected.xlsx");قياس الأعمدة والصفوف
حدد عرض الأعمدة وارتفاع الصفوف للتحكم في أبعاد الخلية في ملف XLSX للخروج.
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Wide Column");
worksheet.setColumnWidth(0, 30);
worksheet.setRowHeight(0, 25);
await workbook.save("sized.xlsx");