ExcelScript.DataBarConditionalFormat interface
Представляет тип условной панели данных Excel.
Комментарии
Примеры
/**
* This script creates data bar conditional formatting on the selected range.
* The scale of the data bar goes from 0 to 1000.
*/
function main(workbook: ExcelScript.Workbook) {
// Get the selected range.
const selected = workbook.getSelectedRange();
// Create new conditional formatting on the range.
const format = selected.addConditionalFormat(ExcelScript.ConditionalFormatType.dataBar);
const dataBarFormat: ExcelScript.DataBarConditionalFormat = format.getDataBar();
// Set the lower bound of the data bar formatting to be 0.
const lowerBound: ExcelScript.ConditionalDataBarRule = {
type: ExcelScript.ConditionalFormatRuleType.number,
formula: "0"
};
dataBarFormat.setLowerBoundRule(lowerBound);
// Set the upper bound of the data bar formatting to be 1000.
const upperBound: ExcelScript.ConditionalDataBarRule = {
type: ExcelScript.ConditionalFormatRuleType.number,
formula: "1000"
};
dataBarFormat.setUpperBoundRule(upperBound);
}
Методы
get |
Код цвета HTML, представляющий цвет линии оси в виде #RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "оранжевый"). Значение равно "" (пустая строка), если ось отсутствует или не задано. |
get |
Представление определения оси для панели данных Excel. |
get |
Указывает направление, на котором должен основываться рисунок панели данных. |
get |
Правило для того, что составляет нижнюю границу (и как ее вычислить, если применимо) для панели данных. Объект |
get |
Представление всех значений слева от оси на панели данных Excel. |
get |
Представление всех значений справа от оси на панели данных Excel. |
get |
Если |
get |
Правило для верхней границы гистограммы (и как ее вычислить). Объект |
set |
Код цвета HTML, представляющий цвет линии оси в виде #RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "оранжевый"). Значение равно "" (пустая строка), если ось отсутствует или не задано. |
set |
Представление определения оси для панели данных Excel. |
set |
Указывает направление, на котором должен основываться рисунок панели данных. |
set |
Правило для того, что составляет нижнюю границу (и как ее вычислить, если применимо) для панели данных. Объект |
set |
Если |
set |
Правило для верхней границы гистограммы (и как ее вычислить). Объект |
Сведения о методе
getAxisColor()
Код цвета HTML, представляющий цвет линии оси в виде #RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "оранжевый"). Значение равно "" (пустая строка), если ось отсутствует или не задано.
getAxisColor(): string;
Возвращаемое значение
string
getAxisFormat()
Представление определения оси для панели данных Excel.
getAxisFormat(): ConditionalDataBarAxisFormat;
Возвращаемое значение
getBarDirection()
Указывает направление, на котором должен основываться рисунок панели данных.
getBarDirection(): ConditionalDataBarDirection;
Возвращаемое значение
getLowerBoundRule()
Правило для того, что составляет нижнюю границу (и как ее вычислить, если применимо) для панели данных. Объект ConditionalDataBarRule
должен быть задан как объект JSON (используйте x.lowerBoundRule = {...}
вместо x.lowerBoundRule.formula = ...
).
getLowerBoundRule(): ConditionalDataBarRule;
Возвращаемое значение
getNegativeFormat()
Представление всех значений слева от оси на панели данных Excel.
getNegativeFormat(): ConditionalDataBarNegativeFormat;
Возвращаемое значение
getPositiveFormat()
Представление всех значений справа от оси на панели данных Excel.
getPositiveFormat(): ConditionalDataBarPositiveFormat;
Возвращаемое значение
getShowDataBarOnly()
Если true
значение , то скрывает значения из ячеек, в которых применяется панель данных.
getShowDataBarOnly(): boolean;
Возвращаемое значение
boolean
getUpperBoundRule()
Правило для верхней границы гистограммы (и как ее вычислить). Объект ConditionalDataBarRule
должен быть задан как объект JSON (используйте x.upperBoundRule = {...}
вместо x.upperBoundRule.formula = ...
).
getUpperBoundRule(): ConditionalDataBarRule;
Возвращаемое значение
setAxisColor(axisColor)
Код цвета HTML, представляющий цвет линии оси в виде #RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "оранжевый"). Значение равно "" (пустая строка), если ось отсутствует или не задано.
setAxisColor(axisColor: string): void;
Параметры
- axisColor
-
string
Возвращаемое значение
void
setAxisFormat(axisFormat)
Представление определения оси для панели данных Excel.
setAxisFormat(axisFormat: ConditionalDataBarAxisFormat): void;
Параметры
- axisFormat
- ExcelScript.ConditionalDataBarAxisFormat
Возвращаемое значение
void
setBarDirection(barDirection)
Указывает направление, на котором должен основываться рисунок панели данных.
setBarDirection(barDirection: ConditionalDataBarDirection): void;
Параметры
- barDirection
- ExcelScript.ConditionalDataBarDirection
Возвращаемое значение
void
setLowerBoundRule(lowerBoundRule)
Правило для того, что составляет нижнюю границу (и как ее вычислить, если применимо) для панели данных. Объект ConditionalDataBarRule
должен быть задан как объект JSON (используйте x.lowerBoundRule = {...}
вместо x.lowerBoundRule.formula = ...
).
setLowerBoundRule(lowerBoundRule: ConditionalDataBarRule): void;
Параметры
- lowerBoundRule
- ExcelScript.ConditionalDataBarRule
Возвращаемое значение
void
setShowDataBarOnly(showDataBarOnly)
Если true
значение , то скрывает значения из ячеек, в которых применяется панель данных.
setShowDataBarOnly(showDataBarOnly: boolean): void;
Параметры
- showDataBarOnly
-
boolean
Возвращаемое значение
void
setUpperBoundRule(upperBoundRule)
Правило для верхней границы гистограммы (и как ее вычислить). Объект ConditionalDataBarRule
должен быть задан как объект JSON (используйте x.upperBoundRule = {...}
вместо x.upperBoundRule.formula = ...
).
setUpperBoundRule(upperBoundRule: ConditionalDataBarRule): void;
Параметры
- upperBoundRule
- ExcelScript.ConditionalDataBarRule
Возвращаемое значение
void
Office Scripts