工具 API
slide_ add_ shape
在指定幻灯片插入一个普通形状(rect / ellipse / triangle 等图形预设块)。【重要】必须设置 fill_color 或 border_color 中的至少一个,否则形状对用户不可见,调用会被拒绝。【重要 — 箭头消歧】本工具不支持画两点之间的方向性箭头线条,仅支持 rightArrow / leftArrow 这两种固定方向的图形预设箭头块;如需画"从起点到终点的箭头线",请改用 slide_add_line_shape 并设置 line_type=arrow / doubleArrow。当用户说"加箭头"时,请先询问要的是"线条箭头"(带起点终点)还是"图形箭头"(固定方向的图形块)再决定调哪个工具。page_index 从 0 开始;x/y/w/h 单位为磅(pt,1pt = 12700 EMU);fill_alpha / border_alpha 取值 0~100;border_width 单位为 pt(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_add_shape
- 服务提供方
- 腾讯文档
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
border_alpha边框透明度 0~100,0=完全不透明(默认),100=完全透明(去掉边框);仅 (0, 100) 开区间才显式写入 alpha
border_color边框颜色(RRGGBB);空串表示无边框;传 "none" 移除边框)
border_dash边框线型,如 solid / dash / dot;空串默认 solid
border_width边框宽度(pt);<= 0 取默认 1.0
file_id文档ID,与 file_url 二选一
file_url在线幻灯片URL,与 file_id 二选一
fill_alpha填充透明度 0~100,0=完全不透明(默认),100=完全透明(整个填充被去掉);仅 (0, 100) 开区间才显式写入 alpha
fill_color填充颜色(RRGGBB,无 # 前缀);空串表示无填充
h形状高度(磅 pt,1pt = 12700 EMU),必须 > 0
page_index目标幻灯片页索引,从 0 开始
shape_type形状预设类型,如 rect / ellipse / triangle / rightArrow / leftArrow 等;空串默认 rect。注意:rightArrow / leftArrow 是固定方向的图形预设箭头块,不能指定起点终点;如需画两点之间的方向性箭头线条,请改用 slide_add_line_shape
w形状宽度(磅 pt,1pt = 12700 EMU),必须 > 0
x形状左上角横坐标(磅 pt,1pt = 12700 EMU)
y形状左上角纵坐标(磅 pt,1pt = 12700 EMU)