FormatConditionCollection

FormatConditionCollection class

يمثل التنسيق الشرطي . يمكن أن تحتوي شروط التنسيق على ما يصل إلى ثلاثة تنسيقات شرطية.

public class FormatConditionCollection

الخصائص

اسموصف
Count { get; }يحصل على عدد الشروط .
Item { get; }يحصل على شرط التنسيق بالفهرس .
RangeCount { get; }الحصول على عدد النطاقات المنسقة شرطيًا.

طُرق

اسموصف
Add(CellArea, FormatConditionType, OperatorType, string, string)يضيف شرط تنسيق ونطاق خلية مؤثر إلى FormatConditions يمكن أن تحتوي FormatConditions على ما يصل إلى ثلاثة تنسيقات شرطية. لا يُسمح بالإشارات إلى الأوراق الأخرى في صيغ التنسيق الشرطي.
AddArea(CellArea)يضيف نطاق خلايا منسق شرطيًا.
AddCondition(FormatConditionType)أضف شرط تنسيق .
AddCondition(FormatConditionType, OperatorType, string, string)يضيف شرط تنسيق .
GetCellArea(int)الحصول على نطاق الخلايا المنسق الشرطي بالفهرس.
RemoveArea(int)يزيل نطاق الخلايا المنسق الشرطي بالفهرس.
RemoveArea(int, int, int, int)إزالة التنسيق الشرطي من النطاق.
RemoveCondition(int)يزيل شرط التنسيق بالفهرس.

أمثلة


[C#]

// إنشاء مصنف جديد.
Workbook workbook = new Workbook();

// احصل على ورقة العمل الأولى.
Worksheet sheet = workbook.Worksheets[0];

// يضيف تنسيقًا شرطيًا فارغًا
int index = sheet.ConditionalFormattings.Add();
FormatConditionCollection fcs = sheet.ConditionalFormattings[index];
// يعين نطاق التنسيق الشرطي.
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;
fcs.AddArea(ca);
ca = new CellArea();
ca.StartRow = 1;
ca.EndRow = 1;
ca.StartColumn = 1;
ca.EndColumn = 1;
fcs.AddArea(ca);
// يضيف الشرط.
int conditionIndex = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100");
// يضيف الشرط.
int conditionIndex2 = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100");
// يعين لون الخلفية.
FormatCondition fc = fcs[conditionIndex];
fc.Style.BackgroundColor = Color.Red;
// حفظ ملف Excel
workbook.Save("output.xls");   

[Visual Basic]

'إنشاء كائن مصنف
Dim workbook As Workbook = New Workbook()
Dim sheet As Worksheet = workbook.Worksheets(0)
' يضيف تنسيقًا شرطيًا فارغًا
Dim index As Integer = sheet.ConditionalFormattings.Add()
Dim fcs As FormatConditionCollection = sheet.ConditionalFormattings(index)
'يضبط نطاق التنسيق الشرطي.
Dim ca As CellArea = New CellArea()
ca.StartRow = 0
ca.EndRow = 0
ca.StartColumn = 0
ca.EndColumn = 0
fcs.AddArea(ca)
ca = New CellArea()
ca.StartRow = 1
ca.EndRow = 1
ca.StartColumn = 1
ca.EndColumn = 1
fcs.AddArea(ca)
'يضيف الشرط.
Dim conditionIndex As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100")
'يضيف الشرط.
Dim conditionIndex2 As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100")
'يضبط لون الخلفية.
Dim fc As FormatCondition = fcs(conditionIndex)
fc.Style.BackgroundColor = Color.Red
'حفظ ملف Excel
workbook.Save("output.xls")

أنظر أيضا