أسلوب AddCondFormatDataBar - مرجع مطوري HotXLS

يضيف قاعدة تنسيق شرطي من نوع شريط البيانات لـ Excel 2007+ على نطاق خلايا، ويُرجع كائن TCondFormat بحيث يمكن تنقيح ضبط نقاط القاعدة قبل الحفظ. تُنشئ داخليًا كتلة CONDFMT12 وسجل CF12 عند الحفظ بـ BIFF8؛ وفي مخرجات XLSX تُعرض القاعدة نفسها عبر <cfRule type="dataBar"> الجديد

البنية

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 `$00FF0000`; for green `$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

مثال

AddCondFormatColorScale2

Sheet.AddCondFormatDataBar('A1:A10', $00FF0000);

انظر أيضاً

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule classes