# 表格参数 (Table Props)

表格参数来自 `TableProps`（继承 `TextBaseProps`、`PositionProps`）和 `TableCellProps`（继承 `TextBaseProps`），用于 `slide.addTable()` 方法。

---

## 位置属性 (PositionProps)

- **x**：水平位置
  - 类型：`Coord`（`number | `${number}%``）
  - 单位：英寸（number）或百分比（`'50%'`）

- **y**：垂直位置
  - 类型：`Coord`
  - 单位：英寸或百分比

- **w**：宽度
  - 类型：`Coord`
  - 单位：英寸或百分比

- **h**：高度
  - 类型：`Coord`
  - 单位：英寸或百分比

---

## 表格专有属性 (TableProps)

- **autoPage**：是否启用自动分页
  - 类型：`boolean`
  - 说明：内容溢出时自动创建新幻灯片
  - 默认值：`false`

- **autoPageCharWeight**：自动分页字符权重
  - 类型：`number`
  - 取值范围：`-1.0`–`1.0`
  - 默认值：`0.0`
  - 说明：调整每行字符数，正值使行更长

- **autoPageLineWeight**：自动分页行权重
  - 类型：`number`
  - 取值范围：`-1.0`–`1.0`
  - 默认值：`0.0`
  - 说明：调整每页行数，正值使表格更高

- **autoPageRepeatHeader**：自动分页时重复表头
  - 类型：`boolean`
  - 默认值：`false`
  - 始于：v3.3.0

- **autoPageHeaderRows**：表头行数
  - 类型：`number`
  - 说明：`autoPageRepeatHeader` 为 `true` 时需设置
  - 默认值：`1`
  - 示例：`2`（在前两行在新页上重复）
  - 始于：v3.3.0

- **autoPageSlideStartY**：自动分页新幻灯片的起始 Y 位置
  - 类型：`number`
  - 默认值：幻灯片上边距

- **border**：表格边框
  - 类型：`BorderProps | [BorderProps, BorderProps, BorderProps, BorderProps]`
  - 取值范围：单个值应用于所有四边；数组按上右下左（TRBL）顺序应用于各边

- **colW**：列宽
  - 类型：`number | number[]`
  - 单位：英寸
  - 说明：单个值均匀分配；数组按列依次应用
  - 默认值：基于 `w` 的等宽列

- **fill**：单元格填充
  - 类型：`ShapeFillProps`
  - 子参数：
    - **fill.color**：填充颜色
      - 类型：`Color`
    - **fill.transparency**：透明度
      - 类型：`number`
      - 取值范围：`0`–`100`
      - 默认值：`0`
    - **fill.type**：填充类型
      - 类型：`'none' | 'solid'`
      - 默认值：`'solid'`

- **margin**：单元格边距
  - 类型：`Margin`（`number | [number, number, number, number]`）
  - 单位：pt
  - 说明：影响所有单元格，可被单元格级选项覆盖
  - 默认值：PowerPoint 默认边距

- **objectName**：对象名称
  - 类型：`string`
  - 说明：替代默认的 "Object N" 名称
  - 默认值：`'Object 1'`

- **rowH**：行高
  - 类型：`number | number[]`
  - 单位：英寸
  - 说明：单个值均匀分配；数组按行依次应用
  - 默认值：基于 `h` 的等高行

- **verbose**：详细模式（开发工具）
  - 类型：`boolean`
  - 说明：在控制台输出自动分页计算的详细信息
  - 默认值：`false`

- **align**：水平对齐
  - 类型：`'left' | 'center' | 'right' | 'justify'`
  - 默认值：`'left'`

- **valign**：垂直对齐
  - 类型：`'top' | 'middle' | 'bottom'`
  - 默认值：`'top'`

---

## 表格行与单元格

- **TableCell**：单个单元格
  - 类型：`{ text?: string | TableCell[], options?: TableCellProps }`
  - 说明：`text` 可为字符串或嵌套表格；`options` 为单元格样式

- **TableRow**：表格行
  - 类型：`TableCell[]`
  - 说明：每行由单元格数组组成

- **TableRowSlide**：自动分页产出
  - 类型：`{ rows: TableRow[] }`

---

## 表格单元格属性 (TableCellProps)

继承 `TextBaseProps`。

- **autoPageCharWeight**：自动分页字符权重
  - 类型：`number`
  - 取值范围：`-1.0`–`1.0`
  - 默认值：`0.0`

- **autoPageLineWeight**：自动分页行权重
  - 类型：`number`
  - 取值范围：`-1.0`–`1.0`
  - 默认值：`0.0`

- **border**：单元格边框
  - 类型：`BorderProps | [BorderProps, BorderProps, BorderProps, BorderProps]`
  - 说明：单个值应用于所有四边；数组按上右下左（TRBL）顺序

- **colspan**：列合并
  - 类型：`number`
  - 说明：跨列数

- **fill**：单元格填充
  - 类型：`ShapeFillProps`

- **hyperlink**：单元格超链接
  - 类型：`HyperlinkProps`
  - 子参数：
    - **hyperlink.slide**：链接到页码
      - 类型：`number`
    - **hyperlink.url**：链接 URL
      - 类型：`string`
    - **hyperlink.tooltip**：超链接提示
      - 类型：`string`

- **margin**：单元格边距
  - 类型：`Margin`
  - 单位：pt
  - 默认值：`0`

- **rowspan**：行合并
  - 类型：`number`
  - 说明：跨行数

---

## BorderProps

用于 `border` 属性的类型定义。

- **type**：边框类型
  - 类型：`'none' | 'dash' | 'solid'`
  - 默认值：`'solid'`

- **color**：边框颜色
  - 类型：`HexColor`
  - 格式：6 位十六进制（无 `#`）
  - 默认值：`'666666'`

- **pt**：边框粗细
  - 类型：`number`
  - 单位：pt
  - 默认值：`1`

---

## 已废弃参数 (TableProps)

| 已废弃参数 | 替代参数 | 废弃版本 |
|---|---|---|
| `addHeaderToEach` | `autoPageRepeatHeader` | v3.3.0 |
| `newSlideStartY` | `autoPageSlideStartY` | v3.3.0 |