Class DataBar

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

Describe la regla de formato condicional DataBar.
Esta regla de formato condicional muestra una barra de datos graduada en el rango de celdas.

public class DataBar

Herencia

object ← DataBar

Miembros heredados

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

Ejemplos


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

Worksheet sheet = workbook.Worksheets[0];

//Añadiendo un formato condicional vacío
int index = sheet.ConditionalFormattings.Add();

FormatConditionCollection fcs = sheet.ConditionalFormattings[index];

//Estableciendo el rango de formato condicional.
CellArea ca = new CellArea();

ca.StartRow = 0;

ca.EndRow = 2;

ca.StartColumn = 0;

ca.EndColumn = 0;

fcs.AddArea(ca);

//Añadiendo condición.
int idx = fcs.AddCondition(FormatConditionType.DataBar);

fcs.AddArea(ca);

FormatCondition cond = fcs[idx];

//Obteniendo Databar
DataBar dataBar = cond.DataBar;

dataBar.Color = Color.Orange;

//Estableciendo propiedades de 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;

//Colocando valores en las celdas
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);

//Guardando el archivo de Excel
workbook.Save("book1.xlsx");

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

Dim sheet As Worksheet = workbook.Worksheets(0)

'Añadiendo un formato condicional vacío
Dim index As Integer = sheet.ConditionalFormattings.Add()

Dim fcs As FormatConditionCollection = sheet.ConditionalFormattings(index)

'Estableciendo el rango de formato condicional.
Dim ca As New CellArea()

ca.StartRow = 0

ca.EndRow = 2

ca.StartColumn = 0

ca.EndColumn = 0

fcs.AddArea(ca)

'Añadiendo condición.
Dim idx As Integer = fcs.AddCondition(FormatConditionType.DataBar)

fcs.AddArea(ca)

Dim cond As FormatCondition = fcs(idx)

'Obteniendo Databar
Dim dataBar As DataBar = cond.DataBar

dataBar.Color = Color.Orange

'Estableciendo propiedades de 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

'Colocando valores en las celdas
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)

'Guardando el archivo de Excel
workbook.Save("book1.xlsx")

Propiedades

AxisColor

Obtiene el color del eje para las celdas con formato condicional como barras de datos.

public Color AxisColor { get; set; }

Valor de la propiedad

Color

AxisPosition

Obtiene o establece la posición del eje de las barras de datos especificadas por una regla de formato condicional.

public DataBarAxisPosition AxisPosition { get; set; }

Valor de la propiedad

DataBarAxisPosition

BarBorder

Obtiene un objeto que especifica el borde de una barra de datos.

public DataBarBorder BarBorder { get; }

Valor de la propiedad

DataBarBorder

BarFillType

Obtiene o establece cómo se llena una barra de datos con color.

public DataBarFillType BarFillType { get; set; }

Valor de la propiedad

DataBarFillType

Color

Obtiene o establece el color de esta DataBar.

public Color Color { get; set; }

Valor de la propiedad

Color

Direction

Obtiene o establece la dirección en la que se muestra la barra de datos.

public TextDirectionType Direction { get; set; }

Valor de la propiedad

TextDirectionType

MaxCfvo

Obtiene o establece el objeto de valor máximo de esta DataBar.
No se puede establecer en null o en un CFValueObject con tipo FormatConditionValueType.Min.

public ConditionalFormattingValue MaxCfvo { get; }

Valor de la propiedad

ConditionalFormattingValue

MaxLength

Representa la longitud máxima de la barra de datos.

public int MaxLength { get; set; }

Valor de la propiedad

int

MinCfvo

Obtiene o establece el objeto de valor mínimo de esta DataBar.
No se puede establecer en null o en un CFValueObject con tipo FormatConditionValueType.Max.

public ConditionalFormattingValue MinCfvo { get; }

Valor de la propiedad

ConditionalFormattingValue

MinLength

Representa la longitud mínima de la barra de datos.

public int MinLength { get; set; }

Valor de la propiedad

int

NegativeBarFormat

Obtiene el objeto NegativeBarFormat asociado con una regla de formato condicional de barra de datos.

public NegativeBarFormat NegativeBarFormat { get; }

Valor de la propiedad

NegativeBarFormat

ShowValue

Obtiene o establece la bandera que indica si se deben mostrar los valores de las celdas a las que se aplica esta barra de datos.
El valor predeterminado es true.

public bool ShowValue { get; set; }

Valor de la propiedad

bool

Métodos

ToImage(Cell, ImageOrPrintOptions)

Renderiza la barra de datos en la celda a un arreglo de bytes de imagen.

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

Parámetros

cell Cell

Indica la barra de datos en la que se debe renderizar la celda.

imgOpts ImageOrPrintOptions

ImageOrPrintOptions contiene algunas propiedades de la imagen de salida.

Retorna

byte[]