WebExtension
内容
[
隐藏
]WebExtension class
表示 Web 扩展对象。
要了解更多信息，请访问使用 Office 加载项文档文章。
public class WebExtension
特性
| 姓名 | 描述 |
|---|---|
| AlternateReferences { get; } | 指定对 Web 扩展的备用引用。 |
| Bindings { get; } | 指定 Web 扩展绑定列表。 |
| Id { get; set; } | 唯一标识当前文档中的 Web 扩展实例。 |
| IsFrozen { get; set; } | 指定用户是否可以与 Web 扩展进行交互。 |
| Properties { get; } | 表示一组 Web 扩展自定义属性。 |
| Reference { get; } | 指定对 Web 扩展的主要引用。 |
例子
展示如何向文档添加 Web 扩展。
Document doc = new Document();
// 使用“MyScript”插件创建任务窗格，该插件将由文档使用，
// 然后设置其默认位置。
TaskPane myScriptTaskPane = new TaskPane();
doc.WebExtensionTaskPanes.Add(myScriptTaskPane);
myScriptTaskPane.DockState = TaskPaneDockState.Right;
myScriptTaskPane.IsVisible = true;
myScriptTaskPane.Width = 300;
myScriptTaskPane.IsLocked = true;
// 如果在同一个停靠位置有多个任务窗格，我们可以设置这个索引来排列它们。
myScriptTaskPane.Row = 1;
// 创建一个名为“MyScript Math Sample”的插件，任务窗格将显示在其中。
WebExtension webExtension = myScriptTaskPane.WebExtension;
// 为我们的插件设置应用商店参考参数，例如 ID。
webExtension.Reference.Id = "WA104380646";
webExtension.Reference.Version = "1.0.0.0";
webExtension.Reference.StoreType = WebExtensionStoreType.OMEX;
webExtension.Reference.Store = CultureInfo.CurrentCulture.Name;
webExtension.Properties.Add(new WebExtensionProperty("MyScript", "MyScript Math Sample"));
webExtension.Bindings.Add(new WebExtensionBinding("MyScript", WebExtensionBindingType.Text, "104380646"));
// 允许用户与插件进行交互。
webExtension.IsFrozen = false;
// 我们可以通过开发人员 -> 插件访问 Microsoft Word 中的 Web 扩展。
doc.Save(ArtifactsDir + "Document.WebExtension.docx");
// 像这样一次性删除所有 Web 扩展任务窗格。
doc.WebExtensionTaskPanes.Clear();
Assert.AreEqual(0, doc.WebExtensionTaskPanes.Count);
doc = new Document(ArtifactsDir + "Document.WebExtension.docx");
myScriptTaskPane = doc.WebExtensionTaskPanes[0];
Assert.AreEqual(TaskPaneDockState.Right, myScriptTaskPane.DockState);
Assert.True(myScriptTaskPane.IsVisible);
Assert.AreEqual(300.0d, myScriptTaskPane.Width);
Assert.True(myScriptTaskPane.IsLocked);
Assert.AreEqual(1, myScriptTaskPane.Row);
webExtension = myScriptTaskPane.WebExtension;
Assert.AreEqual(string.Empty, webExtension.Id);
Assert.AreEqual("WA104380646", webExtension.Reference.Id);
Assert.AreEqual("1.0.0.0", webExtension.Reference.Version);
Assert.AreEqual(WebExtensionStoreType.OMEX, webExtension.Reference.StoreType);
Assert.AreEqual(CultureInfo.CurrentCulture.Name, webExtension.Reference.Store);
Assert.AreEqual(0, webExtension.AlternateReferences.Count);
Assert.AreEqual("MyScript", webExtension.Properties[0].Name);
Assert.AreEqual("MyScript Math Sample", webExtension.Properties[0].Value);
Assert.AreEqual("MyScript", webExtension.Bindings[0].Id);
Assert.AreEqual(WebExtensionBindingType.Text, webExtension.Bindings[0].BindingType);
Assert.AreEqual("104380646", webExtension.Bindings[0].AppRef);
Assert.False(webExtension.IsFrozen);
