Office.TaskPane interface

提供管理外接程序的任务窗格的方法。

注解

要求集TaskPaneAPI 1.1

示例

// Adjust the width of the task pane.
const width = 500;
Office.extensionLifeCycle.taskpane.setWidth(width);

方法

setWidth(width)

设置加载项的任务窗格的宽度(以像素为单位)。

方法详细信息

setWidth(width)

设置加载项的任务窗格的宽度(以像素为单位)。

setWidth(width: number): void;

参数

width

number

任务窗格的宽度(以像素为单位)。 最小和最大约束因平台而异。 在 Excel web 版 中,宽度必须介于 350 到 500 像素之间, (含) 。 在 web 上的Word中,宽度必须介于 330 到 500 像素之间, (含) 。 在 Windows 上的 Office 中,宽度必须介于客户端窗口的 51 像素和 50% 之间。

返回

void

注解

要求集TaskPaneAPI 1.1

重要提示:加载项任务窗格的默认宽度因平台而异。

  • Web (Excel) :350 像素

  • Web (Word) :330 像素

  • Windows:51 像素

如果传递的宽度超出了最小和最大约束,则不会调整任务窗格的大小,并且不会显示错误。