DisplayUnitLabel类

代表显示单元标签。

继承： DisplayUnitLabel → ChartTextFrame → ChartFrame

DisplayUnitLabel 类型公开以下成员：

属性

属性	描述
is_inner_mode	指示绘图区尺寸是否包括刻度线和轴标签。 False 指定大小应确定绘图区域、刻度线和轴标签的大小。
border	获取 `Line`。
area	获取 `ChartFrame.area`。
text_font	获取指定 ChartFrame 对象的 `ChartFrame.font` 对象。
text_options	获取并设置文本的选项。
font	获取指定 ChartFrame 对象的 `DisplayUnitLabel.font` 对象。
auto_scale_font	如果对象中的文本字体大小随对象大小变化而变化，则为 True。默认值为 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类