Table

表格绘图的句柄。

静态方法

new

new(
    position: series Position,
    columns: series int,
    rows: series int,
    bg_color: series Color = na,
    frame_color: series Color = na,
    frame_width: series int = 0,
    border_color: series Color = na,
    border_width: series int = 0,
    force_overlay: series bool = false
  ): series Table

在图表上创建一个表格对象。

参数

名称	类型	默认值	说明
position	series Position		表格在图表上的位置（例如，Position.TopLeft、Position.TopCenter 等）。
columns	series int		表中的列数。
rows	series int		表中的行数。
bg_color	series Color	na	表格的背景颜色。
frame_color	series Color	na	表格的边框颜色。
frame_width	series int	0	框架边框宽度（以像素为单位）。
border_color	series Color	na	表格边框颜色。
border_width	series int	0	表格边框宽度（以像素为单位）。
force_overlay	series bool	false	如果为 true，则表格将呈现在顶部。

返回: series Table

静态属性

all

类型: series Array<Table>

返回一个数组，其中填充了脚本绘制的所有当前表。

方法

cell

设置表中特定单元格的属性。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text	series String	na	单元格的文本内容。
width	series float	0	单元格的宽度（以像素为单位）。
height	series float	0	单元格的高度（以像素为单位）。
text_color	series Color	Color.BLACK	文字颜色。
text_halign	series TextHAlign	TextHAlign.Center	水平文本对齐方式。
text_valign	series TextVAlign	TextVAlign.Center	垂直文本对齐方式。
text_size	series int	14	文本大小（以像素为单位）。
bg_color	series Color	na	单元格的背景颜色。
tooltip	series String	na	单元格的工具提示文本。
text_font_family	series FontFamily	FontFamily.Default	文本的字体系列。
text_formatting	const TextFormat	TextFormat.NONE	文本格式选项。

设置表中特定单元格的属性。将文本大小重载为命名常量。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text	series String	na	单元格的文本内容。
width	series float	0	单元格的宽度（以像素为单位）。
height	series float	0	单元格的高度（以像素为单位）。
text_color	series Color	Color.BLACK	文字颜色。
text_halign	series TextHAlign	TextHAlign.Center	水平文本对齐方式。
text_valign	series TextVAlign	TextVAlign.Center	垂直文本对齐方式。
text_size	series Size	Size.Auto	文本大小作为命名常量。
bg_color	series Color	na	单元格的背景颜色。
tooltip	series String	na	单元格的工具提示文本。
text_font_family	series FontFamily	FontFamily.Default	文本的字体系列。
text_formatting	const TextFormat	TextFormat.NONE	文本格式选项。

---

cell_set_bg_color

cell_set_bg_color(
    table_id: series Table,
    column: series int,
    row: series int,
    bg_color: series Color
  )

设置表格中特定单元格的背景颜色。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
bg_color	series Color		单元格的新背景颜色。

---

cell_set_height

cell_set_height(
    table_id: series Table,
    column: series int,
    row: series int,
    height: series float
  )

设置表格中特定单元格的高度。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
height	series float		单元格的新高度（以像素为单位）。

---

cell_set_text

cell_set_text(
    table_id: series Table,
    column: series int,
    row: series int,
    text: series String
  )

设置表格中特定单元格的文本。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text	series String		单元格的新文本内容。

---

cell_set_text_color

cell_set_text_color(
    table_id: series Table,
    column: series int,
    row: series int,
    text_color: series Color
  )

设置表格中特定单元格的文本颜色。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text_color	series Color		单元格的新文本颜色。

---

cell_set_text_font_family

设置表格中特定单元格中文本的字体系列。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text_font_family	series FontFamily		字体系列：FontFamily.Default 或 FontFamily.Monospace。

按名称设置表格单元格的字体系列。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text_font_family	series String		字体系列：「default」或「monospace」。

---

cell_set_text_formatting

cell_set_text_formatting(
    table_id: series Table,
    column: series int,
    row: series int,
    text_formatting: const TextFormat
  )

设置表格中特定单元格中文本的文本格式。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text_formatting	const TextFormat		文本格式选项。

---

cell_set_text_halign

设置表格中特定单元格中文本的水平对齐方式。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text_halign	series TextHAlign		水平文本对齐方式：TextHAlign.Left、TextHAlign.Center 或 TextHAlign.Right。

按名称设置表格单元格的水平对齐方式。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text_halign	series String		水平文本对齐方式：「left」、「center」或「right」。

---

cell_set_text_size

设置表格中特定单元格的文本大小。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text_size	series int		新的文本大小（以像素为单位）。

设置表格中特定单元格的文本大小。使用命名大小常量重载。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text_size	series Size		新的文本大小作为命名常量（Size.Tiny、Size.Small、Size.Normal、Size.Large、Size.Huge）。

---

cell_set_text_valign

设置表格中特定单元格中文本的垂直对齐方式。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text_valign	series TextVAlign		垂直文本对齐方式：TextVAlign.Top、TextVAlign.Center 或 TextVAlign.Bottom。

按名称设置表格单元格的垂直对齐方式。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
text_valign	series String		垂直文本对齐方式：「top」、「center」或「bottom」。

---

cell_set_tooltip

cell_set_tooltip(
    table_id: series Table,
    column: series int,
    row: series int,
    tooltip: series String
  )

设置表格中特定单元格的工具提示。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
tooltip	series String		单元格的新工具提示文本。

---

cell_set_width

cell_set_width(
    table_id: series Table,
    column: series int,
    row: series int,
    width: series float
  )

设置表格中特定单元格的宽度。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
column	series int		单元格的列索引（从 0 开始）。
row	series int		单元格的行索引（从 0 开始）。
width	series float		单元格的新宽度（以像素为单位）。

---

clear

clear(
    table_id: series Table,
    start_column: series int = 0,
    start_row: series int = 0,
    end_column: series int = na,
    end_row: series int = na
  )

清除表格中指定单元格范围的内容。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表。
start_column	series int	0	起始列索引。
start_row	series int	0	起始行索引。
end_column	series int	na	结束列索引。当 na 时，表示最后一列。
end_row	series int	na	结束行索引。当 na 时，表示最后一行。

---

delete

delete(table_id: series Table)

从图表中删除表格。

参数

名称	类型	默认值	说明
table_id	series Table		要删除的表。

---

merge_cells

merge_cells(
    table_id: series Table,
    start_column: series int = 0,
    start_row: series int = 0,
    end_column: series int = na,
    end_row: series int = na
  )

合并表格中指定范围的单元格。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表。
start_column	series int	0	起始列索引。
start_row	series int	0	起始行索引。
end_column	series int	na	结束列索引。当 na 时，表示最后一列。
end_row	series int	na	结束行索引。当 na 时，表示最后一行。

---

set_bg_color

set_bg_color(table_id: series Table, bg_color: series Color)

设置表格的背景颜色。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
bg_color	series Color		表格的新背景颜色。

---

set_border_color

set_border_color(table_id: series Table, border_color: series Color)

设置表格的边框颜色。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
border_color	series Color		表格的新边框颜色。

---

set_border_width

set_border_width(table_id: series Table, border_width: series int)

设置表格的边框宽度。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
border_width	series int		新的边框宽度（以像素为单位）。

---

set_frame_color

set_frame_color(table_id: series Table, frame_color: series Color)

设置表格的框架颜色。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
frame_color	series Color		表格的新框架边框颜色。

---

set_frame_width

set_frame_width(table_id: series Table, frame_width: series int)

设置表格的框架宽度。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
frame_width	series int		新的框架边框宽度（以像素为单位）。

---

set_position

set_position(table_id: series Table, position: series Position)

设置表格的位置。

参数

名称	类型	默认值	说明
table_id	series Table		要修改的表对象。
position	series Position		表在图表上的新位置。