Menu
WPS WPP API 核心参考 — 全局变量、Slide/Shape 操作、文本框、图片、布局
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
布局美化 — 专业排版、配色优化、视觉层次、装饰元素
幻灯片内容生成 — 大纲规划、视觉设计、多种布局模式、批量创建高品质演示文稿
自动执行模式 — 直接生成并执行代码完成用户任务
只读分析模式 — 仅用文本回答，提供设计建议，禁止生成代码
步骤规划模式 — 先输出幻灯片结构大纲，确认后逐步执行
| name | ppt-core-api |
| description | WPS WPP API 核心参考 — 全局变量、Slide/Shape 操作、文本框、图片、布局 |
| version | 1.0.0 |
| tags | ["wps","api","ppt","slides","shapes","core"] |
| modes | ["agent","plan"] |
| context | {"always":true} |
| metadata | {"wps":{"minVersion":"6.0"}} |
var pres = Application.ActivePresentation;
var slideCount = pres.Slides.Count;
var slide = pres.Slides.Item(1); // 1-based 索引
var pageW = pres.PageSetup.SlideWidth; // 默认 960
var pageH = pres.PageSetup.SlideHeight; // 默认 540
// 在末尾添加空白页
pres.Slides.Add(pres.Slides.Count + 1, 12);
// 参数2: Layout 枚举
// 1 = ppLayoutTitle (标题页)
// 2 = ppLayoutText (标题+正文)
// 6 = ppLayoutTitleOnly (仅标题)
// 7 = ppLayoutBlank (空白)
// 12 = ppLayoutCustom (自定义/空白)
var newSlide = pres.Slides.Item(pres.Slides.Count);
// 添加文本框 (left, top, width, height)
var shape = slide.Shapes.AddTextbox(1, 50, 30, 860, 80);
shape.TextFrame.TextRange.Text = "标题文本";
shape.TextFrame.TextRange.Font.Size = 28;
shape.TextFrame.TextRange.Font.Bold = true;
shape.TextFrame.TextRange.Font.Color.RGB = 0x000000; // RGB 格式（非 BGR）
shape.TextFrame.TextRange.Font.Name = "微软雅黑";
// 段落对齐
shape.TextFrame.TextRange.ParagraphFormat.Alignment = 2; // 1=左, 2=居中, 3=右
// 自动换行和内边距
shape.TextFrame.WordWrap = true;
shape.TextFrame.MarginLeft = 10;
shape.TextFrame.MarginTop = 5;
// 矩形 (left, top, width, height)
var rect = slide.Shapes.AddShape(1, 100, 200, 300, 150);
// 常用 AutoShapeType: 1=矩形, 5=圆角矩形, 9=圆形, 13=右箭头
rect.Fill.ForeColor.RGB = 0x4472C4; // 填充色
rect.Fill.Transparency = 0; // 0=不透明, 1=全透明
rect.Line.ForeColor.RGB = 0x2F528F; // 边框色
rect.Line.Weight = 1.5; // 边框宽度
rect.Line.Visible = true;
// 圆角矩形的圆角
rect.Adjustments.Item(1) = 0.2; // 0~1，值越大越圆
// 插入图片
var pic = slide.Shapes.AddPicture(
"/path/to/image.png", // 文件路径
false, // LinkToFile
true, // SaveWithDocument
100, 100, // Left, Top
400, 300 // Width, Height
);
shape.Left = 100; // 左边距（磅）
shape.Top = 200; // 上边距（磅）
shape.Width = 400; // 宽度（磅）
shape.Height = 300; // 高度（磅）
shape.Rotation = 0; // 旋转角度
shape.Delete(); // 删除单个形状
slide.Delete(); // 删除整页幻灯片
pres.Slides.Item(3).Delete(); // 删除第3页
var sel = Application.ActiveWindow.Selection;
// sel.Type: 0=None, 1=Slides, 2=Shapes, 3=Text
if (sel.ShapeRange) {
for (var i = 1; i <= sel.ShapeRange.Count; i++) {
var s = sel.ShapeRange.Item(i);
// 操作选中形状
}
}
slide.NotesPage.Shapes.Item(2).TextFrame.TextRange.Text = "演讲者备注内容";
| 用途 | RGB 值 | 说明 |
|---|---|---|
| 深蓝(品牌色) | 0x4472C4 | 适合标题/强调 |
| 深灰(正文) | 0x333333 | 正文文字 |
| 浅灰(辅助) | 0x999999 | 副标题/说明 |
| 白色 | 0xFFFFFF | 背景/反色文字 |
| 橙色(强调) | 0xED7D31 | CTA/重点 |
| 绿色(正面) | 0x70AD47 | 增长/完成 |
| 红色(警告) | 0xFF0000 | 下降/警告 |