Class DataBar

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

Décrivez la règle de mise en forme conditionnelle DataBar.
Cette règle de mise en forme conditionnelle affiche une barre de données graduée dans la plage de cellules.

public class DataBar

Héritage

object ← DataBar

Membres hérités

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

Exemples


//Instanciation d'un objet Workbook
Workbook workbook = new Workbook();

Worksheet sheet = workbook.Worksheets[0];

//Ajoute une mise en forme conditionnelle vide
int index = sheet.ConditionalFormattings.Add();

FormatConditionCollection fcs = sheet.ConditionalFormattings[index];

//Définit la plage de mise en forme conditionnelle.
CellArea ca = new CellArea();

ca.StartRow = 0;

ca.EndRow = 2;

ca.StartColumn = 0;

ca.EndColumn = 0;

fcs.AddArea(ca);

//Ajoute une condition.
int idx = fcs.AddCondition(FormatConditionType.DataBar);

fcs.AddArea(ca);

FormatCondition cond = fcs[idx];

//Obtenir la barre de données
DataBar dataBar = cond.DataBar;

dataBar.Color = Color.Orange;

//Définir les propriétés de la barre de données
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;

//Mettre les valeurs des cellules
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);

//Sauvegarder le fichier Excel
workbook.Save("book1.xlsx");

'Instanciation d'un objet Workbook
Dim workbook As Workbook = New Workbook()

Dim sheet As Worksheet = workbook.Worksheets(0)

'Ajoute une mise en forme conditionnelle vide
Dim index As Integer = sheet.ConditionalFormattings.Add()

Dim fcs As FormatConditionCollection = sheet.ConditionalFormattings(index)

'Définit la plage de mise en forme conditionnelle.
Dim ca As New CellArea()

ca.StartRow = 0

ca.EndRow = 2

ca.StartColumn = 0

ca.EndColumn = 0

fcs.AddArea(ca)

'Ajoute une condition.
Dim idx As Integer = fcs.AddCondition(FormatConditionType.DataBar)

fcs.AddArea(ca)

Dim cond As FormatCondition = fcs(idx)

'Obtenir la barre de données
Dim dataBar As DataBar = cond.DataBar

dataBar.Color = Color.Orange

'Définir les propriétés de la barre de données
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

'Mettre les valeurs des cellules
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)

'Sauvegarder le fichier Excel
workbook.Save("book1.xlsx")

Propriétés

AxisColor

Obtient la couleur de l’axe pour les cellules avec mise en forme conditionnelle en tant que barres de données.

public Color AxisColor { get; set; }

Valeur de la propriété

Color

AxisPosition

Obtient ou définit la position de l’axe des barres de données spécifiée par une règle de mise en forme conditionnelle.

public DataBarAxisPosition AxisPosition { get; set; }

Valeur de la propriété

DataBarAxisPosition

BarBorder

Obtient un objet qui spécifie la bordure d’une barre de données.

public DataBarBorder BarBorder { get; }

Valeur de la propriété

DataBarBorder

BarFillType

Obtient ou définit comment une barre de données est remplie de couleur.

public DataBarFillType BarFillType { get; set; }

Valeur de la propriété

DataBarFillType

Color

Obtenir ou définir la couleur de cette barre de données.

public Color Color { get; set; }

Valeur de la propriété

Color

Direction

Obtient ou définit la direction dans laquelle la barre de données est affichée.

public TextDirectionType Direction { get; set; }

Valeur de la propriété

TextDirectionType

MaxCfvo

Obtenir ou définir l’objet de valeur maximale de cette barre de données.
Ne peut pas définir null ou CFValueObject avec le type FormatConditionValueType.Min.

public ConditionalFormattingValue MaxCfvo { get; }

Valeur de la propriété

ConditionalFormattingValue

MaxLength

Représente la longueur maximale de la barre de données.

public int MaxLength { get; set; }

Valeur de la propriété

int

MinCfvo

Obtenir ou définir l’objet de valeur minimale de cette barre de données.
Ne peut pas définir null ou CFValueObject avec le type FormatConditionValueType.Max.

public ConditionalFormattingValue MinCfvo { get; }

Valeur de la propriété

ConditionalFormattingValue

MinLength

Représente la longueur minimale de la barre de données.

public int MinLength { get; set; }

Valeur de la propriété

int

NegativeBarFormat

Obtient l’objet NegativeBarFormat associé à une règle de mise en forme conditionnelle de barre de données.

public NegativeBarFormat NegativeBarFormat { get; }

Valeur de la propriété

NegativeBarFormat

ShowValue

Obtenir ou définir le drapeau indiquant s’il faut afficher les valeurs des cellules sur lesquelles cette barre de données est appliquée.
La valeur par défaut est true.

public bool ShowValue { get; set; }

Valeur de la propriété

bool

Méthodes

ToImage(Cell, ImageOrPrintOptions)

Rendre la barre de données dans la cellule en tableau d’octets d’image.

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

Paramètres

cell Cell

Indique la barre de données dans laquelle la cellule doit être rendue.

imgOpts ImageOrPrintOptions

ImageOrPrintOptions contient certaines propriétés de l’image de sortie.

Renvoie

byte[]