Legend类
Legend类
封装表示图表图例的对象。
遗产： Legend →
ChartTextFrame →
ChartFrame
Legend 类型公开以下成员：
特性
| 属性 | 描述 |
|---|---|
| is_inner_mode | 指示绘图区域大小是否包括刻度线和轴标签。 False 指定大小应确定绘图区域、刻度线和轴标签的大小。 |
| border | 获取Line。 |
| area | 获取ChartFrame.area。 |
| text_font | 获取指定ChartFrame对象的ChartFrame.font对象。 |
| text_options | 获取和设置文本的选项。 |
| font | 获取指定ChartFrame对象的ChartFrame.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 | 如果框架有阴影，则为 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 | 获取或设置形状是否应自动调整以完全包含其中描述的文本。自动适配是 当缩放形状内的文本以包含其中的所有文本时。 |
| position | 获取或设置图例位置类型。 |
| legend_entries | 获取指定图表图例中所有 LegendEntry 对象的集合。 不支持设置曲面图的图例条目。 所以如果图表类型是表面图表类型，它将返回null。 |
| legend_entries_labels | 调用 Chart.Calculate() 方法后获取图例条目的标签。 |
| is_over_lay | 获取或设置是否允许其他图表元素与此图表元素重叠。 |
方法
| 方法 | 描述 |
|---|---|
| set_position_auto | 将框架位置设置为自动 |
| characters | 返回一个 Characters 对象，该对象表示文本中的一系列字符。 |
| get_legend_labels | 调用 Chart.Calculate() 方法后获取图例条目的标签。 |
例子
from aspose.cells import Workbook
from aspose.cells.charts import ChartType, LegendPositionType
workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
# Set Legend's width and height
legend = chart.legend
# Legend is at right side of chart by default.
# If the legend is at left or right side of the chart, setting Legend.X property will not take effect.
# If the legend is at top or bottom side of the chart, setting Legend.Y property will not take effect.
legend.y = 1500
legend.width = 50
legend.height = 50
# Set legend's position
legend.position = LegendPositionType.LEFT
