Edit

Office.Tab interface

  • Reference
Package:
office

Represents an individual tab and the state it should have. For code examples, see Enable and Disable Add-in Commands and Create custom contextual tabs.

Remarks

Requirement set: RibbonAPI 1.1

Properties

controls

Specifies one or more of the controls in the tab, such as menu items, buttons, etc.
groups

Specifies one or more of the control groups on the tab.
id

Identifier of the tab as specified in the manifest.
visible

Specifies whether the tab is visible on the ribbon. Used only with contextual tabs.

Property Details

controls

Specifies one or more of the controls in the tab, such as menu items, buttons, etc.

controls?: Control[];

Property Value

Office.Control[]

Remarks

When the Tab object is part of an Office.RibbonUpdaterData object passed to the requestUpdate method of Office.Ribbon, this property specifies the IDs of the controls whose enabled status is to be changed. However, if there is a groups property on the tab, then this property is ignored and the controls properties of the specified groups must be used to change enabled status.

groups

Specifies one or more of the control groups on the tab.

groups?: Group[];

Property Value

Office.Group[]

Remarks

When the Tab object is part of an Office.RibbonUpdaterData object passed to the requestUpdate method of Office.Ribbon, the controls properties of the various Office.Group objects specify which controls have their enabled status changed; the controls property of the Tab object is ignored.

Requirement set: RibbonAPI 1.1

id

Identifier of the tab as specified in the manifest.

id: string;

Property Value

string

visible

Specifies whether the tab is visible on the ribbon. Used only with contextual tabs.

visible?: boolean;

Property Value

boolean

Remarks

Requirement set: RibbonAPI 1.2