يضيف قاعدة تنسيق شرطي من نوع
شريط البيانات لـ Excel 2007+ على نطاق خلايا، ويُرجع كائن
TCondFormat الجديد
البنية
function AddCondFormatDataBar(
const ARange: WideString;
AColor: LongWord;
AMinKind:
TXLSCfValueKind = cfvMinOfRange;
const AMinValue: WideString = '';
AMaxKind:
TXLSCfValueKind = cfvMaxOfRange;
const AMaxValue: WideString = ''):
TCondFormatRule;
| ARange |
WideString. Sqref String, e.g. 'A1:A10' أو 'B2:C20' |
| AColor |
LongWord. لون تعبئة الشريط بصيغة Delphi BGR (R في البايت الأدنى). لتعبئة زرقاء استخدم $00FF0000؛ ولخضراء استخدم $0000FF00 |
| AMinKind / AMaxKind |
TXLSCfValueKind. أنواع العتبة: cfvNumber، cfvMinOfRange، cfvMaxOfRange، cfvPercent، cfvPercentile، cfvFormula، cfvAutoMin، cfvAutoMax. القيم الافتراضية تربط min→cfvMinOfRange و max→cfvMaxOfRange، بما يطابق حدود الشريط التلقائية الافتراضية في Excel |
| AMinValue / AMaxValue |
WideString. Threshold literal (numeric نص لـ cfvNumber/cfvPercent/cfvPercentile, A1-نطاق أو صيغة نص لـ cfvFormula). Ignored لـ cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax |
مثال
Sheet.AddCondFormatDataBar('A1:A10', $00FF0000);
انظر أيضاً