Class DataBar

Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)

Descreve a regra de formatação condicional DataBar.
Esta regra de formatação condicional exibe uma barra de dados graduada na faixa de células.

public class DataBar

Herança

object ← DataBar

Membros Herdados

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Exemplos


//Instanciando um objeto Workbook
Workbook workbook = new Workbook();

Worksheet sheet = workbook.Worksheets[0];

//Adiciona uma formatação condicional vazia
int index = sheet.ConditionalFormattings.Add();

FormatConditionCollection fcs = sheet.ConditionalFormattings[index];

//Define a faixa de formatação condicional.
CellArea ca = new CellArea();

ca.StartRow = 0;

ca.EndRow = 2;

ca.StartColumn = 0;

ca.EndColumn = 0;

fcs.AddArea(ca);

//Adiciona condição.
int idx = fcs.AddCondition(FormatConditionType.DataBar);

fcs.AddArea(ca);

FormatCondition cond = fcs[idx];

//Obtém a DataBar
DataBar dataBar = cond.DataBar;

dataBar.Color = Color.Orange;

//Define propriedades da 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;

//Coloca valores nas células
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);

//Salvando o arquivo Excel
workbook.Save("book1.xlsx");

'Instanciando um objeto Workbook
Dim workbook As Workbook = New Workbook()

Dim sheet As Worksheet = workbook.Worksheets(0)

'Adiciona uma formatação condicional vazia
Dim index As Integer = sheet.ConditionalFormattings.Add()

Dim fcs As FormatConditionCollection = sheet.ConditionalFormattings(index)

'Define a faixa de formatação condicional.
Dim ca As New CellArea()

ca.StartRow = 0

ca.EndRow = 2

ca.StartColumn = 0

ca.EndColumn = 0

fcs.AddArea(ca)

'Adiciona condição.
Dim idx As Integer = fcs.AddCondition(FormatConditionType.DataBar)

fcs.AddArea(ca)

Dim cond As FormatCondition = fcs(idx)

'Obtém a DataBar
Dim dataBar As DataBar = cond.DataBar

dataBar.Color = Color.Orange

'Define propriedades da 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

'Coloca valores nas células
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)

'Salvando o arquivo Excel
workbook.Save("book1.xlsx")

Propriedades

AxisColor

Obtém a cor do eixo para células com formatação condicional como barras de dados.

public Color AxisColor { get; set; }

Valor da Propriedade

Color

AxisPosition

Obtém ou define a posição do eixo das barras de dados especificadas por uma regra de formatação condicional.

public DataBarAxisPosition AxisPosition { get; set; }

Valor da Propriedade

DataBarAxisPosition

BarBorder

Obtém um objeto que especifica a borda de uma barra de dados.

public DataBarBorder BarBorder { get; }

Valor da Propriedade

DataBarBorder

BarFillType

Obtém ou define como uma barra de dados é preenchida com cor.

public DataBarFillType BarFillType { get; set; }

Valor da Propriedade

DataBarFillType

Color

Obtém ou define a cor desta DataBar.

public Color Color { get; set; }

Valor da Propriedade

Color

Direction

Obtém ou define a direção em que a barra de dados é exibida.

public TextDirectionType Direction { get; set; }

Valor da Propriedade

TextDirectionType

MaxCfvo

Obtém ou define o objeto de valor máximo desta DataBar.
Não é possível definir nulo ou CFValueObject com tipo FormatConditionValueType.Min para ele.

public ConditionalFormattingValue MaxCfvo { get; }

Valor da Propriedade

ConditionalFormattingValue

MaxLength

Representa o comprimento máximo da barra de dados.

public int MaxLength { get; set; }

Valor da Propriedade

int

MinCfvo

Obtém ou define o objeto de valor mínimo desta DataBar.
Não é possível definir nulo ou CFValueObject com tipo FormatConditionValueType.Max para ele.

public ConditionalFormattingValue MinCfvo { get; }

Valor da Propriedade

ConditionalFormattingValue

MinLength

Representa o comprimento mínimo da barra de dados.

public int MinLength { get; set; }

Valor da Propriedade

int

NegativeBarFormat

Obtém o objeto NegativeBarFormat associado a uma regra de formatação condicional de barra de dados.

public NegativeBarFormat NegativeBarFormat { get; }

Valor da Propriedade

NegativeBarFormat

ShowValue

Obtém ou define o indicador que indica se os valores das células nos quais esta barra de dados é aplicada devem ser exibidos.
O valor padrão é verdadeiro.

public bool ShowValue { get; set; }

Valor da Propriedade

bool

Métodos

ToImage(Cell, ImageOrPrintOptions)

Renderiza a barra de dados na célula como um array de bytes de imagem.

public byte[] ToImage(Cell cell, ImageOrPrintOptions imgOpts)

Parâmetros

cell Cell

Indica a barra de dados na qual a célula deve ser renderizada

imgOpts ImageOrPrintOptions

ImageOrPrintOptions contém algumas propriedades da imagem de saída

Retorna

byte[]