准备工作
Script Lab 的级初入门教程，到今天就要告一段落了。总结部分，我们来实践一个 PPT 的例子吧。相比 Word 和 Excel 来说，PPT 的 API 的完成度并不高，甚至连启动函数也没有实现（目前有 Excel.run、 Word.run、OneNote.run）。
在 PowerPoint 空间下，仅实现了一个方法，没有像 Excel 或 Word 那样，可以操作的较完整的 API 对象集。
var ppt = PowerPoint.createPresentation;
PPT 目前的主要操作，只能集中在一些 Offie 通用的功能上，依托于 Office 空间下的 context 对象来操作。本次举一个较简单的例子，在 PPT 上插入一个 SVG 的形状，这也是 Script Lab 中自带的一个例子（总共也只有 5个 API 案例）。
代码解析
【完整代码】
$("#insert").click(newImage); function newImage { Office.context.document.setSelectedDataAsync( getImageAsBase64String, { coercionType: Office.CoercionType.XmlSvg, imageLeft: 50, imageTop: 50, imageWidth: 400 }, function(asyncResult) { if (asyncResult.status === Office.AsyncResultStatus.Failed) { console.error(asyncResult.error.message); } } ); } function getImageAsBase64String { // A production add-in code could get an image from an // online source and pass it to a library function that // converts to base 64. var svg ='<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="100%" height="100%" viewBox="0 0 100 100"> <title>SVG Logo</title> <a xlink:href="http://www.w3.org/Graphics/SVG/" target="_parent" xlink:title="W3C SVG Working Group home page">...</g> </g> </a></svg>'; return svg; }
【代码解析】
取得当前页，并插入 SVG 图标（发未选中，则引出发错）：
Office.context.document.setSelectedDataAsync(...)
其实这种调用模式，我们在前期的代码中并未出现过，所以借此机会，讨论下这里的要点。Office API 应用程序中异步函数有通用签名格式，Office API 应用程序中的所有异步函数都有相同的命名约定和相同的基本签名。 每个异步函数的名称都以"Async"结尾，以本次调用的函数为例：其实所有的步函数的签名都遵循以下基本模式：
functionNameAsync(requiredParameters,[, options], [callback]);
必需参数后面另有两个参数：一个包含可选参数的对象和一个回调函数，两者始终都是可选的。异步函数中的可选参数 异步函数签名中的可选 JavaScript 对象是用分号分隔的键/值对的集合，其中的键是参数名称，值是您想对该参数使用的数据。键/值对的顺序无关紧要，只要参数名称正确即可。
以本次调用为例，setSelectedDataAsync 方法具有 Office 应用程序中所有异步函数通用的相同基本签名：
Office.context.document.setSelectedDataAsync( data [, options], callback);
Document.setSelectedDataAsync 也有一个选项对象，其中包含可选参数，但其选项对象的参数与该 API 中其他异步函数的参数不同，因为此函数的用途是设置数据。 因此，
Document.setSelectedDataAsync 的可选参数与设置数据有关：
- coercionType：一个指定所插入数据格式（文本、HTML、OOXML、表或矩阵）的 CoercionType 枚举
- asyncContext：一个用户定义的对象，在作为回调函数唯一参数传递给该函数的 AsyncResult 对象中无变化返回。
AsyncResult 对象在异步函数中的角色 JavaScript API for Office 中异步函数的通用签名中的第三个参数是可选的回调参数。 当运行时调用回调函数时，它会将 AsyncResult 对象作为回调函数唯一的参数传入。AsyncResult 对象包含有关异步操作的信息，如：操作是否成功；发生了什么错误（如果有）；以及异步函数的返回值（如果有）。在返回某种数据或对象的所有异步函数中，AsyncResult 都是可以获得返回值的唯一方式。可以使用 AsyncResult.value 属性实现这一点。
if (asyncResult.status === Office.AsyncResultStatus.Failed)
{
console.error(asyncResult.error.message);
}
【效果图】
后 记
从3月12日起，写了第一篇垫场文章：深度：从 Office 365 新图标来看微软背后的设计新理念。13日开始正式连载 Script Lab 开发系列：尝试：Script Lab，快速 Office 365 开发工具。截止21日（今天）一共写了九篇文章，算是对 Script Lab 的一个初步介绍，也算是下个 Office 365 开发系列的一个垫场。
写作期间得到了不少朋友的帮助。首先是陈希章老师，关于 Office 365 开发的文章，基本上也只有陈老师一家了，他的那本书《Office 365开发入门指南》是国内目前唯一的一本 Office 365 开发相关的，后来又录制了《Office 365 开发入门指南教程》，加上陈老师的博客，都是最有价值的参考资料之一。贾成敏（JasonJia）老师是 Office 365 培训专家，先后分多次给予了 150 元的打赏（还有邹溪源、祝雷两位兄弟），也使我偿到了创作的乐趣，你们的鼓励是我后继续创作动力。最后一并感谢下，共同参加 Office 365 专委会，一直积极参与学习的小伙伴们（截止发文，目前共有 311 名小伙伴了，除前期有 20 名左右的的邀请，其它均来公众号文章末尾的宣传）。
作为一个 VSTO 开发老兵，曾经花了五年时间在国内推广 VSTO 技术，也曾为创造国中的PPT插件市场出了点绵薄之力。Office 365 的开发，包括本期的 Script Lab ，对我来说也是全新的挑战，之前有所耳闻，直到这次才正式下决心开始学习，把这几天来的所学所见以笔记的形式记录下来，所以内容错误和写作上的不合理在所难免，还希望大家见谅（明显的错误己有多处，也希望大家批评指正，并在文末指出来）。但是作为 Office 的下一代开发技术 OfficeJS 代表了 Office 开发的未来，随着 Office 365 市场份额的增加，Web Add-ins 的前途远胜于 VBA/VSTO，目前还是一片蓝海，除了陈希章老师作为微软 Office 365 推广的一张名片，目前入局者并不多，我希望是第二个，更希望有第三个，第一百个，成百上千的开发者和玩家一并参加进，共同打造这个氛围，众乐乐而不是独乐乐！快来加入以下QQ群，你就是其中的一份子，就算是 0 基础也不用怕，必能学成！最近欢迎大家在文末，能够提出一些建议与想法（包括勘误）。
