إعدادات الحدود
إضافة حدود إلى الخلايا
يسمح 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.
- اللون، لون الخط، المحدد من تعداد الألوان.