DataLabels类
DataLabels类
封装指定 Series 的所有 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 | 如果框架有阴影则为真。 |
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 | 获取或设置形状是否应自动调整以完全包含其中描述的文本。自动调整是 当形状内的文本被缩放以包含其中的所有文本时。 |
show_value | 表示指定图表的数据标签值的显示行为。True 表示显示值。False 表示隐藏值。 |
show_cell_range | 指示是否将单元格范围显示为数据标签。 |
show_percentage | 表示指定图表数据标签百分比值的显示行为。True 表示显示百分比值。False 表示隐藏。 |
show_bubble_size | 表示指定图表数据标签百分比值的显示行为。True 表示显示百分比值。False 表示隐藏。 |
show_category_name | 表示指定图表的数据标签类别名称显示行为。True 表示显示图表上数据标签的类别名称。False 表示隐藏。 |
show_series_name | 指示图表上的数据标签是否显示系列名称。 True 表示显示系列名称。False 表示隐藏。 |
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(self) | 将框架位置设置为自动 |
characters(self, start_index, length) | 返回表示文本内字符范围的 Characters 对象。 |
apply_font(self) | 将数据标签的字体应用于所有子节点。 |
例子
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