إعدادات الحدود

إضافة حدود إلى الخلايا

يسمح Microsoft Excel للمستخدمين بتنسيق الخلايا عن طريق إضافة حدود. يعتمد نوع الحد على مكان إضافته. على سبيل المثال، الحد العلوي هو الحد المضاف إلى أعلى موضع من الخلية. يمكن للمستخدمين أيضًا تعديل نمط وخطوط الألوان للحدود.

مع Aspose.Cells for Node.js via C++، يمكن للمطورين إضافة حدود وتخصيص مظهرها بنفس الطريقة المرنة كما في Microsoft Excel.

إضافة حدود إلى الخلايا

توفر مكتبة Aspose.Cells فئة Workbook التي تمثل ملف Excel من Microsoft. تحتوي فئة Workbook على مجموعة worksheets تتيح الوصول إلى كل ورقة عمل في ملف Excel. تمثل ورقة العمل بواسطة فئة Worksheet. توفر فئة Worksheet مجموعة cells. كل عنصر في مجموعة cells يمثل كائن من الفئة Cell.

يقدم Aspose.Cells طريقة getStyle في فئة Cell. تُستخدم طريقة setStyle لتعيين نمط تنسيق الخلية. توفر فئة Style خصائص لإضافة حدود إلى الخلايا.

إضافة حدود إلى خلية

يمكن للمطورين إضافة حدود إلى خلية باستخدام مجموعة borders من كائن Style. يُمرر نوع الحد كفهرس إلى مجموعة borders. جميع أنواع الحدود معرفَة مسبقًا في تعداد BorderType.

تعداد الحدود

أنواع الحدود الوصف
خط حد فسفلي BottomBorder
خط قطري من أعلى اليسار إلى أسفل اليمين DiagonalDown
خط قطري من أسفل اليسار إلى أعلى اليمين DiagonalUp
خط حد أيسر LeftBorder
خط حد أيمن RightBorder
خط حد علوي TopBorder

تخزن مجموعة borders جميع الحدود. يُمثل كل حد في مجموعة borders بواسطة كائن Border يوفر خصيتين، setColor وsetLineStyle لضبط لون الخط ونمط الحد على التوالي.

لتعيين لون خط الحد، اختر لونًا باستخدام تعداد اللون (جزء من Node.js) وقم بتعيينه إلى خاصية لون كائن الحد.

يتم ضبط نمط خط الحد عن طريق اختيار نمط خط من تعداد CellBorderType.

تعداد CellBorderType

أنماط الخطوط الوصف
DashDot خط متقطع رفيع
DashDotDot خط نقطة متقطعة رفيع
خط متقطع Dashed
خط منقط Dotted
Double خط مزدوج
Hair خط رفيع
MediumDashDot خط متقطع متوسط المتنقل
MediumDashDotDot خط متوسط متقطع بالنقاط
MediumDashed خط متوسط متقطع
None لا يوجد خط
Medium خط متوسط
SlantedDashDot خط مائل متوسط متقطع بالنقاط
Thick خط سميك
Thin خط رفيع
اختر أحد أنماط الخط ثم قم بتعيينه إلى خاصية lineStyle لكائن Border.

إضافة حدود لمجموعة من الخلايا

من الممكن أيضًا إضافة حدود لنطاق من الخلايا بدلاً من خلية واحدة فقط. للقيام بذلك، أولاً، أنشئ نطاق خلايا عبر استدعاء طريقة createRange لمجموعة cells. تأخذ المعلمات التالية:

  • الصف الأول، الصف الأول من المجموعة.
  • العمود الأول، يمثل العمود الأول من المجموعة.
  • عدد الصفوف، عدد الصفوف في المجموعة.
  • عدد الأعمدة، عدد الأعمدة في المجموعة.

تعيد طريقة createRange كائن Range، الذي يحتوي على النطاق المحدد من الخلايا. يوفر كائن Range طريقة setOutlineBorder التي تأخذ المعلمات التالية لإضافة حد إلى نطاق الخلايا:

  • نوع الحد، نوع الحد، مختار من تعداد BorderType.
  • نمط الخط، نمط خط الحد، مختار من تعداد CellBorderType.
  • اللون، لون الخط، المحدد من تعداد الألوان.