DataLabels类

封装指定系列的所有 DataLabel 对象的集合。

遗产： DataLabels → ChartTextFrame → ChartFrame

DataLabels 类型公开以下成员：

特性

属性	描述
is_inner_mode	指示绘图区域大小是否包括刻度线和轴标签。 False 指定大小应确定绘图区域、刻度线和轴标签的大小。
border	获取`Line`。
area	获取`DataLabels.area`。
text_font	获取指定ChartFrame对象的`ChartFrame.font`对象。
text_options	获取和设置文本的选项。
font	获取DataLabels的字体；
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	如果框架有阴影，则为 true。
shape_properties	获取 `ChartFrame.shape_properties` 对象。
is_default_pos_be_set	指示是否设置默认位置（DefaultX、DefaultY、DefaultWidth 和 DefaultHeight）。
default_x	代表默认位置的x
default_y	代表默认位置的y
default_width	代表默认位置的宽度
default_height	代表默认位置的高度
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	获取或设置形状是否应自动调整以完全包含其中描述的文本。自动适配是当缩放形状内的文本以包含其中的所有文本时。
show_value	表示指定图表的数据标签值显示行为。 True 显示值。假以掩饰。
show_cell_range	指示是否将单元格范围显示为数据标签。
show_percentage	表示指定图表的数据标签百分比值显示行为。 True 显示百分比值。假以掩饰。
show_bubble_size	表示指定图表的数据标签百分比值显示行为。 True 显示百分比值。假以掩饰。
show_category_name	表示指定图表的数据标签类别名称显示行为。如果为 True，则在图表上显示数据标签的类别名称。假以掩饰。
show_series_name	返回或设置一个布尔值以指示图表上数据标签的系列名称显示行为。真实显示系列名称。假以掩饰。
show_legend_key	表示指定图表的数据标签图例键显示行为。如果数据标签图例键可见，则为 true。
number_format	表示 DataLabels 对象的格式字符串。
number	获取和设置内置数字格式。
number_format_linked	如果数字格式链接到单元格则为 True （这样当单元格中的数字格式发生变化时，标签中的数字格式也会发生变化）。
separator_type	获取或设置用于图表上数据标签的分隔符类型。
separator_value	获取或设置用于图表上数据标签的分隔符值。
position	表示数据标签的位置。
is_never_overlap	指示数据标签显示是否从不重叠。（对于饼图）
shape_type	获取或设置数据标签的形状类型。

方法

方法	描述
set_position_auto	将框架位置设置为自动
characters	返回一个 Characters 对象，该对象表示文本中的一系列字符。

例子

from aspose.cells import Workbook
from aspose.cells.charts import LabelPositionType

# Set the DataLabels in the chart
wb = Workbook("chart.xlsx")
chart = wb.worksheets[0].charts[0]
for i in range(len(chart.n_series)):
    datalabels = chart.n_series[i].data_labels
    # Set the position of DataLabels
    datalabels.position = LabelPositionType.INSIDE_BASE
    # Show the category name in the DataLabels
    datalabels.show_category_name = True
    # Show the value in the DataLabels
    datalabels.show_value = True
    # Not show the percentage in the DataLabels
    datalabels.show_percentage = False
    # Not show the legend key.
    datalabels.show_legend_key = False

也可以看看

ChartTextFrame类 DisplayUnitLabel类