HotXLS 文档
首页 目录 概览

AddCondFormatDataBar 方法

Adds an Excel 2007+ Data Bar conditional formatting rule over a cell range, returning the new TCondFormatRule 以便在保存前微调规则的各颜色停靠点。BIFF8 保存时内部会创建 CONDFMT12 块和 CF12 记录；XLSX 输出时同一条规则经由 OOXML <cfRule type="dataBar"> element. (Available since v2.34.0.)

语法

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' or 'B2:C20'
AColor LongWord。数据条填充色，采用 Delphi 的 BGR 格式（R 在低位字节）。蓝色填充请用 $00FF0000; for green $0000FF00
AMinKind / AMaxKind TXLSCfValueKind。阈值类型：cfvNumber、cfvMinOfRange、cfvMaxOfRange、cfvPercent、cfvPercentile、cfvFormula、cfvAutoMin、cfvAutoMax。默认映射为 min→cfvMinOfRange、max→cfvMaxOfRange，与 Excel 默认的 "自动" 条形边界一致
AMinValue / AMaxValue WideString。阈值字面量（cfvNumber/cfvPercent/cfvPercentile 用数字文本，cfvFormula 用 A1 范围或公式文本）。cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax 会忽略该值

示例

此示例在 A1:A10 上添加蓝色数据条，使用默认的范围最小/最大边界 

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

请参阅

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule classes