Class DataBar

Class DataBar

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

Popisuje pravidlo podmínkového formátování DataBar.
Toto pravidlo podmínkového formátování zobrazuje gradovanou
datovou lištu v rozsahu buněk.

public class DataBar

Dědění

object ←
DataBar

Děděné členy

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

Příklady 


//Instanciace objektu Workbook
Workbook workbook = new Workbook();

Worksheet sheet = workbook.Worksheets[0];

//Přidání prázdného podmínkového formátování
int index = sheet.ConditionalFormattings.Add();

FormatConditionCollection fcs = sheet.ConditionalFormattings[index];

//Nastavení rozsahu podmínkového formátu.
CellArea ca = new CellArea();

ca.StartRow = 0;

ca.EndRow = 2;

ca.StartColumn = 0;

ca.EndColumn = 0;

fcs.AddArea(ca);

//Přidání podmínky.
int idx = fcs.AddCondition(FormatConditionType.DataBar);

fcs.AddArea(ca);

FormatCondition cond = fcs[idx];

//Získání Databar
DataBar dataBar = cond.DataBar;

dataBar.Color = Color.Orange;

//Nastavení vlastností 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;

//Vložení hodnot buněk
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);

//Uložení Excel souboru
workbook.Save("book1.xlsx");

'Instanciace objektu Workbook
Dim workbook As Workbook = New Workbook()

Dim sheet As Worksheet = workbook.Worksheets(0)

'Přidání prázdného podmínkového formátování
Dim index As Integer = sheet.ConditionalFormattings.Add()

Dim fcs As FormatConditionCollection = sheet.ConditionalFormattings(index)

'Nastavení rozsahu podmínkového formátu.
Dim ca As New CellArea()

ca.StartRow = 0

ca.EndRow = 2

ca.StartColumn = 0

ca.EndColumn = 0

fcs.AddArea(ca)

'Přidání podmínky.
Dim idx As Integer = fcs.AddCondition(FormatConditionType.DataBar)

fcs.AddArea(ca)

Dim cond As FormatCondition = fcs(idx)

'Získání Databar
Dim dataBar As DataBar = cond.DataBar

dataBar.Color = Color.Orange

'Nastavení vlastností 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

'Vložení hodnot buněk
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)

'Uložení Excel souboru
workbook.Save("book1.xlsx")

Vlastnosti

AxisColor

Získá barvu osy pro buňky s podmínkovým formátováním jako datové lišty.

public Color AxisColor { get; set; }

Hodnota vlastnosti

Color

AxisPosition

Získá nebo nastaví pozici osy datových lišt určenou pravidlem podmínkového formátování.

public DataBarAxisPosition AxisPosition { get; set; }

Hodnota vlastnosti

DataBarAxisPosition

BarBorder

Získá objekt, který specifikuje okraj datové lišty.

public DataBarBorder BarBorder { get; }

Hodnota vlastnosti

DataBarBorder

BarFillType

Získá nebo nastaví, jak je datová lišta vyplněna barvou.

public DataBarFillType BarFillType { get; set; }

Hodnota vlastnosti

DataBarFillType

Color

Získá nebo nastaví barvu této DataBar.

public Color Color { get; set; }

Hodnota vlastnosti

Color

Direction

Získá nebo nastaví směr, ve kterém je datová lišta zobrazena.

public TextDirectionType Direction { get; set; }

Hodnota vlastnosti

TextDirectionType

MaxCfvo

Získá nebo nastaví maximální hodnotu objektu této DataBar.
Nelze nastavit null nebo CFValueObject s typem FormatConditionValueType.Min.

public ConditionalFormattingValue MaxCfvo { get; }

Hodnota vlastnosti

ConditionalFormattingValue

MaxLength

Reprezentuje maximální délku datové lišty.

public int MaxLength { get; set; }

Hodnota vlastnosti

int

MinCfvo

Získá nebo nastaví minimální hodnotu objektu této DataBar.
Nelze nastavit null nebo CFValueObject s typem FormatConditionValueType.Max.

public ConditionalFormattingValue MinCfvo { get; }

Hodnota vlastnosti

ConditionalFormattingValue

MinLength

Reprezentuje minimální délku datové lišty.

public int MinLength { get; set; }

Hodnota vlastnosti

int

NegativeBarFormat

Získá objekt NegativeBarFormat spojený s pravidlem podmínkového formátování datové lišty.

public NegativeBarFormat NegativeBarFormat { get; }

Hodnota vlastnosti

NegativeBarFormat

ShowValue

Získá nebo nastaví flag označující, zda zobrazit hodnoty buněk, na které se tato datová lišta aplikuje.
Výchozí hodnota je true.

public bool ShowValue { get; set; }

Hodnota vlastnosti

bool

Metody

ToImage(Cell, ImageOrPrintOptions)

Vykreslí datovou lištu v buňce do pole bajtů obrázku.

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

Parametry

cell Cell

Určuje, ve které buňce má být datová lišta vykreslena.

imgOpts ImageOrPrintOptions

ImageOrPrintOptions obsahuje některé vlastnosti výstupního obrázku.

Návratová hodnota

byte[]

 Čeština