Office.Addin interface

Represents a modal notification dialog that can appear when the user attempts to close a document. The document won't close until the user responds. This API is only supported in Excel.

beforeDocumentCloseNotification: BeforeDocumentCloseNotification;

Property Value

Remarks

Requirement set: SharedRuntime 1.2

Gets the current startup behavior for the add-in.

getStartupBehavior(): Promise<Office.StartupBehavior>;

Returns

Remarks

Requirement set: SharedRuntime 1.1

Hides the task pane.

hide(): Promise<void>;

Returns

A promise that is resolved when the UI is hidden.

Remarks

Requirement set: SharedRuntime 1.1

Adds a handler for the onVisibilityModeChanged event.

onVisibilityModeChanged(
            handler: (message: VisibilityModeChangedMessage) => void,
        ): Promise<() => Promise<void>>;

Parameters

Returns

A promise that resolves to a function when the handler is added. Calling it removes the handler.

Remarks

Requirement set: SharedRuntime 1.1

Examples

Office.onReady(() => {
    Office.addin.onVisibilityModeChanged((args) => {
        if (args.visibilityMode === Office.VisibilityMode.taskpane) {
            // Do something when the task pane is visible.
        }
    });

    // Other startup tasks.
});

Sets the startup behavior for the add-in for when the document is opened next time.

setStartupBehavior(behavior: Office.StartupBehavior): Promise<void>;

Parameters

Returns

Remarks

Requirement set: SharedRuntime 1.1

Examples

// Configure your add-in to load and start running when the document is opened.
Office.addin.setStartupBehavior(Office.StartupBehavior.load);

Shows the task pane associated with the add-in.

showAsTaskpane(): Promise<void>;

Returns

A promise that is resolved when the UI is shown.

Remarks

Requirement set: SharedRuntime 1.1