DataBar Klasse

DataBar Klasse

Beschreiben Sie die bedingte Formatierungsregel DataBar. Diese bedingte Formatierungsregel zeigt eine abgestufte Darstellung an Datenleiste im Zellbereich.

Der Typ DataBar macht die folgenden Member verfügbar:

Eigenschaften

EigentumBeschreibung
axis_colorRuft die Farbe der Achse für Zellen mit bedingter Formatierung als Datenbalken ab.
axis_positionRuft die Position der Achse der durch eine bedingte Formatierungsregel angegebenen Datenbalken ab oder legt diese fest.
bar_fill_typeRuft ab oder legt fest, wie eine Datenleiste mit Farbe gefüllt wird.
directionRuft die Richtung ab, in der die Datenleiste angezeigt wird, oder legt diese fest.
bar_borderRuft ein Objekt ab, das den Rahmen einer Datenleiste angibt.
negative_bar_formatRuft das NegativeBarFormat-Objekt ab, das einer bedingten Formatierungsregel für Datenleisten zugeordnet ist.
min_cfvoRufen Sie das Mindestwertobjekt dieser DataBar ab oder legen Sie es fest.
Null oder CFValueObject mit dem Typ FormatConditionValueType.Max können nicht darauf festgelegt werden.
max_cfvoRufen Sie das Maximalwertobjekt dieser DataBar ab oder legen Sie es fest.
Null oder CFValueObject mit dem Typ FormatConditionValueType.Min können nicht darauf festgelegt werden.
colorRufen Sie die Farbe dieser DataBar ab oder legen Sie sie fest.
min_lengthStellt die Mindestlänge der Datenleiste dar.
max_lengthStellt die maximale Länge der Datenleiste dar.
show_valueRufen Sie das Flag ab, das angibt, ob die Werte der Zellen angezeigt werden sollen, auf die diese Datenleiste angewendet wird, oder legen Sie es fest.
Der Standardwert ist wahr.

Methoden

MethodeBeschreibung
to_imageRendern Sie die Datenleiste in der Zelle in ein Bild-Byte-Array.

Beispiel

from aspose.cells import CellArea, DataBarAxisPosition, DataBarBorderType, DataBarFillType, DataBarNegativeColorType, FormatConditionType, FormatConditionValueType, Workbook
from aspose.pydrawing import Color

# Instantiating a Workbook object
workbook = Workbook()
sheet = workbook.worksheets[0]
# Adds an empty conditional formatting
index = sheet.conditional_formattings.add()
fcs = sheet.conditional_formattings[index]
# Sets the conditional format range.
ca = CellArea()
ca.start_row = 0
ca.end_row = 2
ca.start_column = 0
ca.end_column = 0
fcs.add_area(ca)
# Adds condition.
idx = fcs.add_condition(FormatConditionType.DATA_BAR)
fcs.add_area(ca)
cond = fcs[idx]
# Get Databar
dataBar = cond.data_bar
dataBar.color = Color.orange
# Set Databar properties
dataBar.min_cfvo.type = FormatConditionValueType.PERCENTILE
dataBar.min_cfvo.value = 30
dataBar.show_value = False
dataBar.bar_border.type = DataBarBorderType.SOLID
dataBar.bar_border.color = Color.plum
dataBar.bar_fill_type = DataBarFillType.SOLID
dataBar.axis_color = Color.red
dataBar.axis_position = DataBarAxisPosition.MIDPOINT
dataBar.negative_bar_format.color_type = DataBarNegativeColorType.COLOR
dataBar.negative_bar_format.color = Color.white
dataBar.negative_bar_format.border_color_type = DataBarNegativeColorType.COLOR
dataBar.negative_bar_format.border_color = Color.yellow
# Put Cell Values
cell1 = sheet.cells.get("A1")
cell1.put_value(10)
cell2 = sheet.cells.get("A2")
cell2.put_value(120)
cell3 = sheet.cells.get("A3")
cell3.put_value(260)
# Saving the Excel file
workbook.save("book1.xlsx")

Siehe auch