إعدادات التعبئة
الألوان وأنماط الخلفية
يمكن لبرنامج Microsoft Excel تعيين ألوان الأمام (الإطار) والخلفية (تعبئة) للخلايا وأنماط الخلفية.
تدعم Aspose.Cells أيضًا هذه الميزات بطريقة مرنة. في هذا الموضوع، نتعلم كيفية استخدام هذه الميزات باستخدام Aspose.Cells.
تعيين الألوان وأنماط الخلفية
توفر أسبوس.خلايات فئة، Workbook التي تمثل ملف Microsoft Excel. تحتوي فئة Workbook على مجموعة Worksheets التي تسمح بالوصول إلى كل ورقة عمل في ملف Excel. تُمثل ورقة العمل بواسطة فئة Worksheet. توفر فئة Worksheet مجموعة Cells. كل عنصر في مجموعة Cells يُمثل كائنًا من فئة Cell.
Cell لديها GetStyle و SetStyle الأساليب التي تستخدم للحصول وتعيين تنسيق الخلية. يوفر فئة Style خصائص لضبط لوني النص الأمامي والخلفية للخلايا. توفر Aspose.Cells تعدادًا BackgroundType يحتوي على مجموعة من أنواع أنماط الخلفية المحددة مسبقًا كما هو موضح أدناه.
أنماط الخلفية | الوصف |
---|---|
DiagonalCrosshatch | تمثل نمط شفة الصليب المائل |
DiagonalStripe | يمثل نمط خط مائل |
Gray6 | يمثل نمط رمادي بنسبة 6.25٪ |
Gray12 | يمثل نمط رمادي بنسبة 12.5٪ |
Gray25 | يمثل نمط رمادي بنسبة 25٪ |
Gray50 | يمثل نمط رمادي بنسبة 50٪ |
Gray75 | يمثل نمط رمادي بنسبة 75٪ |
HorizontalStripe | يمثل نمط خط أفقي |
None | يمثل عدم وجود خلفية |
ReverseDiagonalStripe | يمثل نمط خط مائل عكسي |
Solid | يمثل نمط صلب |
ThickDiagonalCrosshatch | يمثل نمط علامة تقاطع مائلة سميكة |
ThinDiagonalCrosshatch | يمثل نمط علامة تقاطع مائلة رفيعة |
ThinDiagonalStripe | يمثل نمط خط مائل رفيع |
ThinHorizontalCrosshatch | يمثل نمط علامة تقاطع أفقي رفيعة |
ThinHorizontalStripe | يمثل نمط خط أفقي رفيع |
ThinReverseDiagonalStripe | يمثل نمط خط مائل عكسي رفيع |
ThinVerticalStripe | يمثل نمط خط عمودي رفيع |
VerticalStripe | يمثل نمط خط عمودي |
في المثال أدناه ، تم تعيين لون الخلفية للخلية A1 ولكن تم تكوين A2 ليكون لها كل من لون الخلفية والأمامية مع نمط خلفية خط عمودي.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiating a Workbook object | |
Workbook workbook = new Workbook(); | |
// Adding a new worksheet to the Workbook object | |
int i = workbook.Worksheets.Add(); | |
// Obtaining the reference of the newly added worksheet by passing its sheet index | |
Worksheet worksheet = workbook.Worksheets[i]; | |
// Define a Style and get the A1 cell style | |
Style style = worksheet.Cells["A1"].GetStyle(); | |
// Setting the foreground color to yellow | |
style.ForegroundColor = Color.Yellow; | |
// Setting the background pattern to vertical stripe | |
style.Pattern = BackgroundType.VerticalStripe; | |
// Apply the style to A1 cell | |
worksheet.Cells["A1"].SetStyle(style); | |
// Get the A2 cell style | |
style = worksheet.Cells["A2"].GetStyle(); | |
// Setting the foreground color to blue | |
style.ForegroundColor = Color.Blue; | |
// Setting the background color to yellow | |
style.BackgroundColor = Color.Yellow; | |
// Setting the background pattern to vertical stripe | |
style.Pattern = BackgroundType.VerticalStripe; | |
// Apply the style to A2 cell | |
worksheet.Cells["A2"].SetStyle(style); | |
// Saving the Excel file | |
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003); |
مهم معرفته
- لتعيين لون الخلفية أو اللون الأمامي لخلية ما، استخدم خصائص ForegroundColor أو BackgroundColor لكائن Style. سوف تؤثر كلا الخصائص فقط إذا تم تكوين خصية Pattern لكائن Style.
- تعيين الظل للخلية تحدد خاصية ForegroundColor لون الخلية. تحدد الخاصية Pattern نوع نمط الخلفية المستخدمة للألوان الأمامية أو الخلفية. يوفر Aspose.Cells تعدادًا، BackgroundType. يحتوي على مجموعة من الأنماط القياسية المحددة مسبقًا لأنماط الخلفية.
- إذا قمت بتحديد قيمة BackgroundType.None من تعداد BackgroundType، لن يتم تطبيق اللون الأمامي. بالمثل، لن يتم تطبيق اللون الخلفي إذا قمت باختيار القيم BackgroundType.None أو BackgroundType.Solid.
- عند استرجاع لون السطوع/التعبئة للخلية، إذا كان Style.Pattern يساوي BackgroundType.None، سيقوم Style.ForegroundColor بإرجاع Color.Empty.
تطبيق تأثيرات تعبئة التدرج
لتطبيق تأثيرات تعبئة التدرج المرغوبة على الخلية، استخدم الطريقة SetTwoColorGradient لكائن Style وفقًا لذلك.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Instantiate a new Workbook | |
Workbook workbook = new Workbook(); | |
// Get the first worksheet (default) in the workbook | |
Worksheet worksheet = workbook.Worksheets[0]; | |
// Input a value into B3 cell | |
worksheet.Cells[2, 1].PutValue("test"); | |
// Get the Style of the cell | |
Style style = worksheet.Cells["B3"].GetStyle(); | |
// Set Gradient pattern on | |
style.IsGradient = true; | |
// Specify two color gradient fill effects | |
style.SetTwoColorGradient(Color.FromArgb(255, 255, 255), Color.FromArgb(79, 129, 189), GradientStyleType.Horizontal, 1); | |
// Set the color of the text in the cell | |
style.Font.Color = Color.Red; | |
// Specify horizontal and vertical alignment settings | |
style.HorizontalAlignment = TextAlignmentType.Center; | |
style.VerticalAlignment = TextAlignmentType.Center; | |
// Apply the style to the cell | |
worksheet.Cells["B3"].SetStyle(style); | |
// Set the third row height in pixels | |
worksheet.Cells.SetRowHeightPixel(2, 53); | |
// Merge the range of cells (B3:C3) | |
worksheet.Cells.Merge(2, 1, 1, 2); | |
// Save the Excel file | |
workbook.Save(dataDir + "output.xlsx"); |
الألوان واللوحة
اللوحة هي عدد الألوان المتاحة للاستخدام في إنشاء صورة. يتيح استخدام لوحة معيارية في العرض للمستخدم إنشاء مظهر متسق. كل ملف من ملفات Microsoft Excel (97-2003) لديه لوحة تتكون من 56 لون يمكن تطبيقها على الخلايا، الخطوط، الخطوط الشبكية، الكائنات الرسومية، التعبئات والخطوط في الرسم البياني.
مع Aspose.Cells، يمكن للمستخدم استخدام الألوان الموجودة في اللوحة بالإضافة إلى الألوان المخصصة. قبل استخدام لون مخصص، قم بإضافته إلى اللوحة أولاً.
يناقش هذا الموضوع كيفية إضافة ألوان مخصصة إلى اللوحة.
إضافة ألوان مخصصة إلى اللوحة
تدعم Aspose.Cells لوحة الألوان من Microsoft Excel التي تتكون من 56 لون. لاستخدام لون مخصص غير معرف في اللوحة، أضف اللون إلى اللوحة.
توفر Aspose.Cells فئة، Workbook، التي تمثل ملف Microsoft Excel. تقدم فئة Workbook طريقة ChangePalette التي تأخذ المعلمات التالية لإضافة لون مخصص لتعديل اللوحة:
- لون مخصص، اللون المخصص الذي سيتم إضافته.
- الفهرس، فهرس اللون في اللوحة الذي سيحل محل اللون المخصص. يجب أن يكون بين 0-55.
المثال أدناه يضيف لون مخصص (Orchid) إلى اللوحة قبل تطبيقه على خط النص.
// Instantiating an Workbook object | |
Workbook workbook = new Workbook(); | |
//Checks if a color is in the palette for the spreadsheet. | |
Console.WriteLine(workbook.IsColorInPalette(Color.Orchid)); | |
// Adding Orchid color to the palette at 55th index | |
workbook.ChangePalette(Color.Orchid, 55); | |
Console.WriteLine(workbook.IsColorInPalette(Color.Orchid)); | |
// Adding a new worksheet to the Excel object | |
int i = workbook.Worksheets.Add(); | |
// Obtaining the reference of the newly added worksheet by passing its sheet index | |
Worksheet worksheet = workbook.Worksheets[i]; | |
// Accessing the "A1" cell from the worksheet | |
Cell cell = worksheet.Cells["A1"]; | |
// Adding some value to the "A1" cell | |
cell.PutValue("Hello Aspose!"); | |
// Defining new Style object | |
Style styleObject = workbook.CreateStyle(); | |
// Setting the Orchid (custom) color to the font | |
styleObject.Font.Color = workbook.Colors[55]; | |
// Applying the style to the cell | |
cell.SetStyle(styleObject); | |
// Saving the Excel file | |
workbook.Save("out.xlsx"); |