Skip to main content

AddDatabar

Adds a new data bar conditional formatting rule to the collection.

Syntax​

expression.AddDatabar();

expression - A variable that represents a ApiFormatConditions class.

Parameters​

This method doesn't have any parameters.

Returns​

ApiDatabar | null

Example​

Show in-cell progress bars that represent each value proportionally within a range in a spreadsheet.

// How do I add visual bars inside cells to compare numbers without creating a separate chart in a spreadsheet?

// Turn a column of numbers into an instant bar-chart view using built-in cell formatting in a spreadsheet.

let worksheet = Api.GetActiveSheet();

worksheet.GetRange("A1").SetValue("Budget Progress");
worksheet.GetRange("A2").SetValue(25);
worksheet.GetRange("A3").SetValue(85);
worksheet.GetRange("A4").SetValue(60);
worksheet.GetRange("A5").SetValue(95);
worksheet.GetRange("A6").SetValue(40);
worksheet.GetRange("A7").SetValue(75);
worksheet.GetRange("A8").SetValue(30);
worksheet.GetRange("A9").SetValue(90);

let dataRange = worksheet.GetRange("A2:A9");

let formatConditions = dataRange.GetFormatConditions();

formatConditions.AddDatabar();