Class DataBar
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Опишите правило условного форматирования DataBar.
Это правило условного форматирования отображает градиентную
полосу данных в диапазоне ячеек.
public class DataBar
Наследование
Унаследованные члены
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Примеры
//Создание объекта Workbook
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
//Добавляет пустое условное форматирование
int index = sheet.ConditionalFormattings.Add();
FormatConditionCollection fcs = sheet.ConditionalFormattings[index];
//Устанавливает диапазон условного формата.
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 2;
ca.StartColumn = 0;
ca.EndColumn = 0;
fcs.AddArea(ca);
//Добавляет условие.
int idx = fcs.AddCondition(FormatConditionType.DataBar);
fcs.AddArea(ca);
FormatCondition cond = fcs[idx];
//Получить Databar
DataBar dataBar = cond.DataBar;
dataBar.Color = Color.Orange;
//Установить свойства Databar
dataBar.MinCfvo.Type = FormatConditionValueType.Percentile;
dataBar.MinCfvo.Value = 30;
dataBar.ShowValue = false;
dataBar.BarBorder.Type = DataBarBorderType.Solid;
dataBar.BarBorder.Color = Color.Plum;
dataBar.BarFillType = DataBarFillType.Solid;
dataBar.AxisColor = Color.Red;
dataBar.AxisPosition = DataBarAxisPosition.Midpoint;
dataBar.NegativeBarFormat.ColorType = DataBarNegativeColorType.Color;
dataBar.NegativeBarFormat.Color = Color.White;
dataBar.NegativeBarFormat.BorderColorType = DataBarNegativeColorType.Color;
dataBar.NegativeBarFormat.BorderColor = Color.Yellow;
//Установить значения ячеек
Aspose.Cells.Cell cell1 = sheet.Cells["A1"];
cell1.PutValue(10);
Aspose.Cells.Cell cell2 = sheet.Cells["A2"];
cell2.PutValue(120);
Aspose.Cells.Cell cell3 = sheet.Cells["A3"];
cell3.PutValue(260);
//Сохранение файла Excel
workbook.Save("book1.xlsx");
'Создание объекта Workbook
Dim workbook As Workbook = New Workbook()
Dim sheet As Worksheet = workbook.Worksheets(0)
'Добавляет пустое условное форматирование
Dim index As Integer = sheet.ConditionalFormattings.Add()
Dim fcs As FormatConditionCollection = sheet.ConditionalFormattings(index)
'Устанавливает диапазон условного формата.
Dim ca As New CellArea()
ca.StartRow = 0
ca.EndRow = 2
ca.StartColumn = 0
ca.EndColumn = 0
fcs.AddArea(ca)
'Добавляет условие.
Dim idx As Integer = fcs.AddCondition(FormatConditionType.DataBar)
fcs.AddArea(ca)
Dim cond As FormatCondition = fcs(idx)
'Получить Databar
Dim dataBar As DataBar = cond.DataBar
dataBar.Color = Color.Orange
'Установить свойства Databar
dataBar.MinCfvo.Type = FormatConditionValueType.Percentile
dataBar.MinCfvo.Value = 30
dataBar.ShowValue = False
dataBar.BarBorder.Type = DataBarBorderType.Solid
dataBar.BarBorder.Color = Color.Plum
dataBar.BarFillType = DataBarFillType.Solid
dataBar.AxisColor = Color.Red
dataBar.AxisPosition = DataBarAxisPosition.Midpoint
dataBar.NegativeBarFormat.ColorType = DataBarNegativeColorType.Color
dataBar.NegativeBarFormat.Color = Color.White
dataBar.NegativeBarFormat.BorderColorType = DataBarNegativeColorType.Color
dataBar.NegativeBarFormat.BorderColor = Color.Yellow
'Установить значения ячеек
Dim cell1 As Aspose.Cells.Cell = sheet.Cells("A1")
cell1.PutValue(10)
Dim cell2 As Aspose.Cells.Cell = sheet.Cells("A2")
cell2.PutValue(120)
Dim cell3 As Aspose.Cells.Cell = sheet.Cells("A3")
cell3.PutValue(260)
'Сохранение файла Excel
workbook.Save("book1.xlsx")
Свойства
AxisColor
Получает цвет оси для ячеек с условным форматированием в виде полос данных.
public Color AxisColor { get; set; }
Значение свойства
AxisPosition
Получает или устанавливает позицию оси полос данных, указанную правилом условного форматирования.
public DataBarAxisPosition AxisPosition { get; set; }
Значение свойства
BarBorder
Получает объект, который задает границу полосы данных.
public DataBarBorder BarBorder { get; }
Значение свойства
BarFillType
Получает или устанавливает способ заполнения полосы данных цветом.
public DataBarFillType BarFillType { get; set; }
Значение свойства
Color
Получает или устанавливает цвет этой DataBar.
public Color Color { get; set; }
Значение свойства
Direction
Получает или устанавливает направление, в котором отображается полоса данных.
public TextDirectionType Direction { get; set; }
Значение свойства
MaxCfvo
Получает или устанавливает объект максимального значения этой DataBar.
Нельзя установить null или CFValueObject с типом FormatConditionValueType.Min.
public ConditionalFormattingValue MaxCfvo { get; }
Значение свойства
MaxLength
Представляет максимальную длину полосы данных.
public int MaxLength { get; set; }
Значение свойства
MinCfvo
Получает или устанавливает объект минимального значения этой DataBar.
Нельзя установить null или CFValueObject с типом FormatConditionValueType.Max.
public ConditionalFormattingValue MinCfvo { get; }
Значение свойства
MinLength
Представляет минимальную длину полосы данных.
public int MinLength { get; set; }
Значение свойства
NegativeBarFormat
Получает объект NegativeBarFormat, связанный с правилом условного форматирования полосы данных.
public NegativeBarFormat NegativeBarFormat { get; }
Значение свойства
ShowValue
Получает или устанавливает флаг, указывающий, следует ли отображать значения ячеек, к которым применяется эта полоса данных.
Значение по умолчанию - true.
public bool ShowValue { get; set; }
Значение свойства
Методы
ToImage(Cell, ImageOrPrintOptions)
Отрисовать полосу данных в ячейке в массив байтов изображения.
public byte[] ToImage(Cell cell, ImageOrPrintOptions imgOpts)
Параметры
cell
Cell
Указывает на полосу данных, которая будет отрисована в ячейке
imgOpts
ImageOrPrintOptions
ImageOrPrintOptions содержит некоторые свойства выходного изображения
Возвращает
byte[]