DisplayUnitLabel класс

DisplayUnitLabel класс

Представляет собой этикетку блока отображения.

Наследование: DisplayUnitLabel → ChartTextFrame → ChartFrame

Тип DisplayUnitLabel предоставляет следующие элементы:

Характеристики

СвойствоОписание
is_inner_modeУказывает, включает ли размер области графика деления и подписи осей.
Значение False указывает, что размер будет определять размер области графика, отметок и подписей осей.
borderПолучает Line.
areaПолучает ChartFrame.area.
text_fontПолучает объект ChartFrame.font указанного объекта ChartFrame.
text_optionsПолучает и задает параметры текста.
fontПолучает объект DisplayUnitLabel.font указанного объекта ChartFrame.
auto_scale_fontTrue, если размер шрифта текста в объекте изменяется при изменении размера объекта. Значение по умолчанию — True.
background_modeПолучает и задает режим отображения фона
backgroundПолучает и задает режим отображения фона
is_automatic_sizeУказывает, автоматически ли изменяется размер рамки диаграммы.
xВозвращает или задает координату x верхнего левого угла в единицах 1/4000 области диаграммы.
yВозвращает или задает координату Y верхнего левого угла в единицах 1/4000 области диаграммы.
heightВозвращает или задает высоту кадра в единицах 1/4000 области диаграммы.
widthВозвращает или задает ширину рамки в единицах 1/4000 области диаграммы.
shadowИстина, если у рамки есть тень.
shape_propertiesПолучает объект ChartFrame.shape_properties.
is_default_pos_be_setУказывает, задано ли положение по умолчанию (DefaultX, DefaultY, DefaultWidth и DefaultHeight).
default_xПредставляет x позиции по умолчанию в единицах, равных 1/4000 площади диаграммы.
default_yПредставляет y положения по умолчанию в единицах, равных 1/4000 площади диаграммы.
default_widthПредставляет ширину позиции по умолчанию в единицах 1/4000 области диаграммы.
default_heightПредставляет высоту позиции по умолчанию в единицах, равных 1/4000 площади диаграммы.
default_x_ratio_to_chartПредставляет x позиции по умолчанию в единицах доли области диаграммы.
default_y_ratio_to_chartПредставляет y положения по умолчанию в единицах доли области диаграммы.
default_width_ratio_to_chartПредставляет ширину позиции по умолчанию в единицах доли области диаграммы.
default_height_ratio_to_chartПредставляет высоту позиции по умолчанию в единицах доли области диаграммы.
x_ratio_to_chartВозвращает или задает координату x верхнего левого угла в единицах отношения площади диаграммы.
y_ratio_to_chartВозвращает или задает координату Y верхнего левого угла в единицах отношения площади диаграммы.
width_ratio_to_chartВозвращает или задает ширину рамки в единицах отношения площади диаграммы.
height_ratio_to_chartВозвращает или задает высоту рамки в единицах отношения площади диаграммы.
x_pixelВозвращает или задает координату x верхнего левого угла в пикселях.
y_pixelВозвращает или задает координату Y верхнего левого угла в пикселях.
width_pixelВозвращает или задает ширину кадра в пикселях.
height_pixelВозвращает или задает высоту кадра в пикселях.
is_auto_textУказывает, что текст сгенерирован автоматически.
is_deletedУказывает, удалены ли эти метки данных.
text_horizontal_alignmentПолучает и задает горизонтальное выравнивание текста.
text_vertical_alignmentПолучает или задает вертикальное выравнивание текста.
rotation_angleПредставляет угол поворота текста.
is_automatic_rotationУказывает, поворачивается ли текст диаграммы автоматически.
textВозвращает или задает текст метки отображаемого блока.
linked_sourceПолучает и задает ссылку на рабочий лист.
text_directionПредставляет порядок чтения текста.
reading_orderПредставляет порядок чтения текста.
direction_typeПолучает и задает направление текста.
is_text_wrappedВозвращает или задает значение, указывающее, переносится ли текст.
is_resize_shape_to_fit_textВозвращает или задаёт, должна ли фигура автоматически подгоняться под размер текста, описанного внутри неё. Автоматическая подгонка — это
когда текст внутри фигуры масштабируется так, чтобы вместить весь текст внутри.

Методы

МетодОписание
set_position_auto(self)Установить положение рамки на автоматическое
characters(self, start_index, length)Возвращает объект Characters, представляющий диапазон символов в тексте.

Пример

from aspose.cells import Workbook
from aspose.cells.charts import ChartType, DisplayUnitType

# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Excel object
sheetIndex = workbook.worksheets.add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.worksheets[sheetIndex]
# Adding a sample value to "A1" cell
worksheet.cells.get("A1").put_value(50)
# Adding a sample value to "A2" cell
worksheet.cells.get("A2").put_value(100)
# Adding a sample value to "A3" cell
worksheet.cells.get("A3").put_value(150)
# Adding a sample value to "A4" cell
worksheet.cells.get("A4").put_value(200)
# Adding a sample value to "B1" cell
worksheet.cells.get("B1").put_value(60)
# Adding a sample value to "B2" cell
worksheet.cells.get("B2").put_value(32)
# Adding a sample value to "B3" cell
worksheet.cells.get("B3").put_value(50)
# Adding a sample value to "B4" cell
worksheet.cells.get("B4").put_value(40)
# Adding a sample value to "C1" cell as category data
worksheet.cells.get("C1").put_value("Q1")
# Adding a sample value to "C2" cell as category data
worksheet.cells.get("C2").put_value("Q2")
# Adding a sample value to "C3" cell as category data
worksheet.cells.get("C3").put_value("Y1")
# Adding a sample value to "C4" cell as category data
worksheet.cells.get("C4").put_value("Y2")
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.COLUMN, 5, 0, 15, 5)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B4"
chart.n_series.add("A1:B4", True)
# Setting the data source for the category data of NSeries
chart.n_series.category_data = "C1:C4"
# Setting the display unit of value(Y) axis.
chart.value_axis.display_unit = DisplayUnitType.HUNDREDS
displayUnitLabel = chart.value_axis.display_unit_label
# Setting the custom display unit label
displayUnitLabel.text = "100"
# Saving the Excel file
workbook.save("book1.xls")

Смотрите также

DataLabels класс DropBars класс