14 分钟
Word JavaScript API 支持以编程方式控制 Word 文档中的文本、格式、选择和范围。 在本单元中，你将学习如何使用文本、段落、将样式和格式应用于文本，以及如何使用自定义 Word 加载项中的选择和文本范围。Office 开发人员平台概述Microsoft 365开发人员平台（包括 Office）为开发人员提供了许多用于嵌入自定义项的画布，Office 加载项是三个画布之一：文档、对话和页面。Microsoft Teams 在用户之间进行对话，使开发人员能够使用消息传递扩展、对话机器人和其他自定义选项来扩展体验。开发人员使用 SharePoint 框架 自定义 SharePoint Server 和 SharePoint Online 中的页面。还可以扩展 Office 客户端（如 Word、Excel、PowerPoint、OneNote 和 Outlook）以使用加载项实现自定义任务窗格、操作和其他自定义项。适用于 Microsoft Word 的 Office.js 加载项剖析首先，我们将了解适用于 Microsoft Word 的 Office.js 的剖析：当页面首次加载加载项时，所有 Office 加载项都必须停止 Office.initialize() 方法。
如果在加载项中使用较新的 Office.js 功能，请务必使用 requirements API 检查客户端是否支持这些扩展。
对于 Word JavaScript API，你可以使用 Word.run() 方法获取当前文档 context 的实例。
引用当前 Word 文档的 context 后，可以使用load()方法加载上下文中的任何属性。 此方法将添加请求队列，以便出于性能原因将多个请求链接在一起。
准备好检索已排队的属性或执行任何排队操作时，请使用context.sync() 方法执行使用 load() 方法定义的一批排队操作。
context.sync()方法将返回一个 JavaScript 承诺，可用于获取结果或上一个操作并执行新操作。
最佳做法是，应侦听、捕获和处理使用 Word JavaScript API 时可能发生的任何错误。
文本和段落Word 加载项开发人员应了解 Word 文档的层次结构，以及它与 Office.js 中的对象之间的关系。Office.js 通过 Word.run 和 context.document 属性为 Word 文档提供上下文。
文档包含正文，其中包含许多集合，包括段落、表格等。此层次结构中的关系在 API 中公开为属性，允许向上遍历（例如：paragraph.parentBody）、向下遍历（例如：body.paragraphs）和水平遍历（例如：paragraph.getNext() 或 paragraph.getPrevious()）。Office.js 允许插入新段落，并编辑、删除、清除现有段落，以及它们在文档中的显示方式。段落使用 getNext() 和 getPrevious() 操作以及使用 after 位置的 before 插入相对于自身的段落时，来识别同级。以下代码片段演示了使用 Word JavaScript API 的工作文本和段落的工作示例：获取对文档正文的引用：
const docBody = context.document.body;
在文档正文的开头插入段落：
docBody.insertParagraph('Hello World', 'Start');
获取对文档正文中第一个段落的引用：
const paragraph = context.document.body.paragraphs.getFirst();
获取对文档正文中第二个段落的引用：
const paragraph = context.document.body.paragraphs.getFirst().getNext();
获取对文档正文中最后一个段落的引用：
const paragraph = context.document.body.paragraphs.getLast();
在当前段落位置后面插入段落：
paragraph.insertParagraph('Hello World', 'After');
清除段落的内容：
paragraph.clear();
删除文档中的第一个段落：
const paragraph = context.document.body.paragraphs.items[0].delete();
在段落后面插入分页符：
paragraph.insertBreak('page', 'After');
循环访问文档中的所有段落：
const paragraphs = context.document.body.paragraphs;
context.load(paragraphs, 'text');
return context.sync().then(() => {
for (let i = 0; i < paragraphs.items.length; i++) {
// do something with paragraph (paragraphs.items[i])
}
}).then(context.sync);
样式和文本格式设置样式和格式设置使文档更具吸引力。 借助 Office.js，可以轻松地使用自定义 Word 加载项中的样式和格式设置。样式Microsoft Word 中的样式类似于 HTML 中的 CSS 类。 它们提供一组预配置的可重用格式，应用于段落或文本范围。Office.js 可以将默认样式和自定义样式应用于段落和文本范围。字体修改字体类似于在 HTML 中应用内联样式。 设置字体可以操作字体系列、粗细、大小、颜色等。与样式一样，字体可以应用于整个段落或文本范围。段落格式除样式和字体外，段落还通过 Office.js 提供更多格式设置，例如对齐、缩进和行距。以下代码片段演示了如何使用 Word JavaScript API，将样式和格式设置应用到文本和段落的工作示例：为段落应用一个著名的 Word 样式：
paragraph.styleBuiltIn = Word.Style.intenseReference;
向段落应用自定义样式：
paragraph.style = 'MyCustomStyle';
使用 left、centered、right 或 justified 设置段落对齐属性：
paragraph.alignment = 'centered';
更改文本范围的字体
range.font.set({
name: 'Courier New',
bold: true,
size: 18,
color: '#0000ff',
highlightColor: '#ffff00'
});
选择和范围使用 Office 加载项时，开发人员通常会听到术语范围一词。 范围是 Microsoft Word 中文档的任何连续区域。范围可以通过多种方式建立，包括搜索、选择或转换。 例如，paragraph.getRange() 方法将段落作为范围返回。选择使你可以操作文档中焦点的内容和位置。可以获取区域选择，或在区域上设置所选内容以下代码片段演示了如何使用 Word JavaScript API，获取和使用文本和段落选项的工作示例：获取所选文本范围：
const originalRange = document.getSelection();
将文本追加到文本范围：
originalRange.insertText('added to the end', 'End');
使用 Select、Start 或 End 的节模式选择文本范围：
someRange.select('Select');
在当前段落中搜索一段文本并将其替换：
const ranges = paragraph.search('office', {matchCase: true, ignoreSpace: true});
context.load(ranges);
return context.sync().then(() => {
for (let i = 0; i < ranges.items.length; i++) {
ranges.items[i].insertText("Office", "Replace");
}
}).then(context.sync);
摘要Word JavaScript API 支持以编程方式控制 Word 文档中的文本、格式设置、选择和范围。 在本单元中，你将学习如何使用文本、段落、将样式和格式应用于文本，以及如何使用自定义 Word 加载项中的选择和文本范围。
}

时间：2023-06-05 11:29:06作者：极光下载站人气：1　　很多小伙伴在选择编辑文字文档的程序时都会将Word程序放在首选，因为Word中的功能十分的丰富，可以满足我们对于文字文档编辑的各种需求。在使用Word选择编辑文字文档的过程中，有的小伙伴想要在粘贴文字时不改变文字元贝的格式，但又不知道该怎么进行设置。其实很简单，我们只需要打开“粘贴”工具下的箭头图标，然后在下拉列表中点击“选择性粘贴”选项，接着在选择性粘贴页面中选择“带格式文本”选项即可。有的小伙伴可能不清楚具体的操作方法，接下来小编就来和大家分享一下Word粘贴原格式不变的方法。方法步骤　　1、第一步，我们在电脑中找到自己想要编辑的文字文档，然后右键单击该文档并依次点击“打开方式”和“Word”选项　　2、第二步，进入Word页面之后，我们在文档页面中找到自己想要复制的文字区域，选中该区域，或是直接使用“Ctrl+A”选中全文　　3、第三步，我们右键单击选中的文字，然后在菜单列表中选择“复制”选项，或是使用快捷键“Ctrl+C”进行复制　　4、第四步，我们将鼠标光标放在需要粘贴文字的位置，然后点击“开始”子工具栏中的“粘贴”工具下的箭头图标，接着在下拉列表中点击选择“选择性粘贴”选项　　5、第五步，进入选择性粘贴页面之后，我们在该页面中点击选择“带格式文本”选项，最后点击确定选项即可　　以上就是小编整理总结出的关于Word粘贴原格式不变的方法，我们在Word中先将需要粘贴的文字选中，然后使用快捷键进行复制，接着将鼠标光标放在需要粘贴的位置，然后打开“粘贴”选项下的箭头图标并在下拉列表中选择“选择性粘贴”选项，最后在选择性粘贴页面中点击选择“带格式文本”选项即可，感兴趣的小伙伴快去试试吧。microsoft office2019专业增强版大小：10.22 MB版本：永久激活版(附激活密钥)环境：WinXP, Win7, Win10进入下载
标签Word粘贴原格式不变,Word}