Office.Actions interface

包:

office

管理操作和键盘快捷方式。

方法

areShortcutsInUse(shortcuts)	根据另一个加载项或 Office 应用程序的定义，检查用户当前是否正在使用一组快捷键组合。 有关详细信息，请参阅 向 Office 外接程序添加自定义键盘快捷方式。
associate(actionId, actionFunction)	将操作的 ID 或名称与函数相关联。
getShortcuts()	获取加载项的现有快捷方式。 该集始终包括 (1) 加载项清单中为键盘快捷方式定义的快捷方式， (2) 当前用户的自定义快捷方式（如果存在）。 如果快捷方式与另一个外接程序的快捷方式或 Office 应用程序冲突，则快捷方式可以是 null 。 具体而言，当系统提示用户选择要使用的快捷方式时，用户未选择当前加载项的操作时，将 null 会出现此情况。 有关快捷方式冲突的详细信息，请参阅 避免其他加载项使用的键组合。
replaceShortcuts(shortcuts)	将现有外接程序快捷方式替换为用户的自定义快捷方式。

方法详细信息

areShortcutsInUse(shortcuts)

根据另一个加载项或 Office 应用程序的定义，检查用户当前是否正在使用一组快捷键组合。 有关详细信息，请参阅 向 Office 外接程序添加自定义键盘快捷方式。

areShortcutsInUse(shortcuts: string[]): Promise<Array<{shortcut: string, inUse: boolean}>>;

参数

shortcuts

string[]

快捷方式组合的数组。 例如， ["Ctrl+1", "Ctrl+2"]。

返回

Promise<Array<{shortcut: string, inUse: boolean}>>

解析为对象数组的 promise。 每个对象由快捷键组合和布尔值组成。 如果快捷方式组合与另一个外接程序的快捷方式或 Office 应用程序的快捷方式冲突，则值为 true ;否则为 false。 例如， [{shortcut:"Ctrl+1", inUse:true},{shortcut:"Ctrl+2", inUse:false}]。

注解

要求集：

• KeyboardShortcuts 1.1

• SharedRuntime 1.1

associate(actionId, actionFunction)

将操作的 ID 或名称与函数相关联。

associate(actionId: string, actionFunction: (arg?: any) => void): void;

参数

actionId

string

清单中定义的操作的 ID。

actionFunction

(arg?: any) => void

调用操作时运行的函数。

返回

void

getShortcuts()

获取加载项的现有快捷方式。 该集始终包括 (1) 加载项清单中为键盘快捷方式定义的快捷方式， (2) 当前用户的自定义快捷方式（如果存在）。 如果快捷方式与另一个外接程序的快捷方式或 Office 应用程序冲突，则快捷方式可以是 null 。 具体而言，当系统提示用户选择要使用的快捷方式时，用户未选择当前加载项的操作时，将 null 会出现此情况。 有关快捷方式冲突的详细信息，请参阅 避免其他加载项使用的键组合。

getShortcuts(): Promise<{[actionId: string]: string|null}>;

返回

Promise<{[actionId: string]: string|null}>

一个承诺，该承诺解析为快捷方式的对象，其中键是操作的 ID，值是快捷方式组合。 例如， {"SetItalic": "Ctrl+1", "SetBold": "Ctrl+2", "SetUnderline": null}。

注解

要求集：

• KeyboardShortcuts 1.1

• SharedRuntime 1.1

replaceShortcuts(shortcuts)

将现有外接程序快捷方式替换为用户的自定义快捷方式。

replaceShortcuts(shortcuts: {[actionId: string]: string}): Promise<void>;

参数

shortcuts

{[actionId: string]: string}

自定义快捷方式的对象，其中键是操作的 ID，值是快捷方式组合。 例如， {"SetItalic": "Ctrl+1", "SetBold": "Ctrl+2"}。 若要了解如何指定有效的操作 ID 和组合键，请参阅 向 Office 外接程序添加自定义键盘快捷方式。 (请注意，组合键可以是 null，在这种情况下，操作将保留 JSON 文件中指定的组合键。)

返回

Promise<void>

一个承诺，用于在中 shortcuts 注册每个自定义快捷方式分配时解决。 即使与现有快捷方式发生冲突，也会注册自定义快捷方式。 否则，承诺将被拒绝，并显示错误代码和错误消息。 如果 中的任何 shortcuts 操作 ID 不存在，或者快捷方式组合无效，则返回“InvalidOperation”错误代码。

注解

要求集：

• KeyboardShortcuts 1.1

• SharedRuntime 1.1