工具 API
slide_
修改幻灯片中一个或多个形状的属性。支持三种使用模式：(A) 单形状模式：传入 shape_id + 属性字段（位置/尺寸/旋转/填充/边框）。(B) 批量一对一模式：传入 shapes 数组，每项包含 shape_id 及各自的属性（填充/边框/位置/尺寸/旋转）。视觉属性变更合并为一次撤销单元，transform 变更合并为另一次撤销单元。(C) 批量多对一模式：传入 shape_ids 数组 + 顶层属性，所有形状统一应用相同变更。未指定的属性保持不变。形状类型支持说明：- 普通形状(shape/connector)：支持 fill_color / fill_alpha / border_color / border_alpha / border_width / border_dash / 位置尺寸旋转。- 图片形状(picture)：支持 fill_alpha（控制整张图片透明度）/ border_color / border_alpha / border_width / border_dash / 位置尺寸旋转；不支持 fill_color（图片颜色由图片本身决定）。- 其他类型（表格、图表等）：仅支持位置/尺寸/旋转，不支持 fill/border 颜色属性。坐标 / 尺寸单位为磅（pt，1pt = 12700 EMU）；rotation 单位为度；border_width 单位为磅（pt）；border_dash 为 OOXML STPresetLineDashVal 字符串（如 "solid" / "dash" / "dashDot"）（SLIDE） if both tencent-docs (personal) and tencent-docs-oa (enterprise) are connected, use AskUserQuestion to let the user pick the target account before invoking this tool.
调用信息
- 工具标识
- tencent-docs.slide_set_shape_properties
- 服务提供方
- 腾讯文档
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
border_alpha边框透明度，百分比 0-100（0=完全不透明，100=完全透明）。设置 border_color 时若不传则默认 0。普通形状和图片形状均支持
border_color十六进制边框色（如 "000000"）。传 "none" 移除边框。不传则保持不变。普通形状和图片形状均支持
border_dash边框线型：solid/dot/dash/lgDash/dashDot/lgDashDot/lgDashDotDot/sysDash/sysDot/sysDashDot/sysDashDotDot。不传则保持不变
border_width边框宽度，单位磅（1pt=12700 EMU）。不传则保持不变
file_id文档ID，与 file_url 二选一
file_url在线幻灯片URL，与 file_id 二选一
fill_alpha填充透明度，百分比 0-100（0=完全不透明，100=完全透明）。对普通形状控制 solidFill 透明度；对图片形状控制图片整体透明度（alphaModFix）。设置 fill_color 时若不传则默认 0
fill_color十六进制填充色（如 "FF0000"）。传 "none" 移除填充。不传则保持不变。图片形状不支持此属性
h新的高度，单位磅。不传则保持不变
page_index目标幻灯片页索引，从 0 开始
rotation旋转角度（度），如 90 表示顺时针旋转 90°。不传则保持不变
shape_id单形状模式 (A)：要修改的形状 ID
shape_ids批量多对一模式 (C)：形状 ID 数组，所有形状统一应用顶层属性。与 shape_id、shapes 互斥
shapes批量一对一模式 (B)：对象数组，单元素字段：shape_id / fill_color / fill_alpha / border_color / border_alpha / border_width / border_dash / x / y / w / h / rotation。与 shape_id、shape_ids 互斥
w新的宽度，单位磅。不传则保持不变
x新的 X 坐标，单位磅。不传则保持不变
y新的 Y 坐标，单位磅。不传则保持不变