DataBar

DataBar class

Опишите правило условного форматирования DataBar. Это правило условного форматирования отображает гистограмму данных gradated в диапазоне ячеек.

public class DataBar

Характеристики

Имя Описание
AxisColor { get; set; } Получает цвет оси для ячеек с условным форматированием в виде гистограмм.
AxisPosition { get; set; } Получает или задает положение оси гистограмм, заданное правилом условного форматирования.
BarBorder { get; } Получает объект, указывающий границу гистограммы данных.
BarFillType { get; set; } Получает или задает способ заполнения панели данных цветом.
Color { get; set; } Получить или установить цвет этой панели данных.
Direction { get; set; } Получает или задает направление отображения панели данных.
MaxCfvo { get; } Получить или установить объект максимального значения этого DataBar. Невозможно установить для него null или CFValueObject с типом FormatConditionValueType.Min.
MaxLength { get; set; } Представляет максимальную длину строки данных.
MinCfvo { get; } Получить или установить объект минимального значения этого DataBar. Невозможно установить для него null или CFValueObject с типом FormatConditionValueType.Max.
MinLength { get; set; } Представляет минимальную длину строки данных.
NegativeBarFormat { get; } Получает объект NegativeBarFormat, связанный с правилом условного форматирования гистограммы.
ShowValue { get; set; } Получить или установить флаг, указывающий, следует ли отображать значения ячеек, к которым применяется эта панель данных. Значение по умолчанию — true.

Методы

Имя Описание
ToImage(Cell, ImageOrPrintOptions) Отобразить панель данных в ячейке в массив байтов изображения.

Примеры


[C#]

//Создание экземпляра объекта 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 = cond.DataBar;

dataBar.Color = Color.Orange;

//Задаем свойства панели данных
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");

[VB.NET]

'Создание экземпляра объекта 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)

'Получить панель данных
Dim dataBar As DataBar = cond.DataBar

dataBar.Color = Color.Orange

'Установить свойства панели данных
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")

Смотрите также