工具 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.

productivityOAuth1 积分

调用信息

工具标识
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)