自定义功能区概述

自定义功能区采用通用的 CustomUI 标准进行配置，该标准定义了一整套标准的控件，比如按钮、下拉菜单、组合框；能够对控件的标签、图标、点击事件等属性进行配置。下面通过一个示例进行详细说明。

图 1. Web 加载项自定义功能区

JavaScript

<customUI xmlns="http://schemas.microsoft.com/office/2006/01/customui" onLoad="OnAddInLoad">
    <ribbon startFromScratch="false">
        <tabs>
            <tab id="WebAddinDemo" label="Web 加载项示例">
                <group id="btnGroup" label="示例分组">
                    <button onAction="OnClicked" label="示例按钮" getImage="GetImage"/>
                </group>
            </tab>
        </tabs>
    </ribbon>
</customUI>

标记说明

onLoad 代表一个事件，仅在 WPS 应用装载该 WPS 加载项时触发一次。OnAddInLoad是开发者自定义的 JavaScript 函数，通常用来执行一些初始化操作。
tabs 可以包含多个 tab，每一个 tab 对应一个自定义功能区。
group 将多个控件划分成不同的分组，便于将相互关联的功能组织在一起。
button 是一个按钮。onAction在用户点击后触发，OnClicked是开发者自定义的 JavaScript 函数。label 是按钮文字标签，getImage 用来自定义按钮图表 GetImage是开发者自定义的 JavaScript 函数，getImage 首先会在自定义功能区第一次显示的时候执行一次。当开发者调用刷新整个功能区或通过id刷新该控件时再次执行。

OA 助手

运行宏

界面组成

自定义功能区

Application

属性

方法

TaskPane

属性

方法

事件

ApiEvent

属性

方法

PluginStorage

属性

方法

FileSystem

属性

方法

Env

方法

OAAssist

方法

表格事件

文字事件

演示事件

控件事件

Debug

方法

函数

枚举

CheckBox

属性

方法

ComboBox

属性

方法

CommandButton

属性

方法

Frame

属性

方法

HLayout

属性

方法

HSpacer

属性

Label

属性

方法

ListBox

属性

方法

MultiPage

属性

方法

OptionButton

属性

方法

ScrollBar

属性

方法

SpinButton

属性

方法

TextEdit

属性

方法

ToggleButton

属性

方法

UserForm

属性

方法

VLayout

属性

方法

VSpace

自定义功能区概述

标记说明

更多说明