Document.getActiveViewAsync method

Returns the state of the current view of the presentation (edit or read).

Office.context.document.getActiveViewAsync([,options], callback);

Parameters

Callback Value

When the function you passed to the callback parameter executes, it receives an AsyncResult object that you can access from the callback function's only parameter.

In the callback function passed to the getActiveViewAsync method, the AsyncResult.value property returns the state of the presentation's current view. The value returned can be either edit or read. edit corresponds to any of the views in which you can edit slides, such as Normal or Outline View. read corresponds to either Slide Show or Reading View.

Remarks

Can trigger an event when the view changes.

Example

To get the view of the current presentation, you need to write a callback function that returns that value. The following example shows how to:

• Pass an anonymous callback function that returns the view type to the callback parameter of the getActiveViewAsync method.

• Display the value on the add-in's page.

function getFileView() {
    // Get whether the current view is edit or read.
    Office.context.document.getActiveViewAsync(function (asyncResult) {
        if (asyncResult.status == "failed") {
            showMessage("Action failed with error: " + asyncResult.error.message);
        }
        else {
            showMessage(asyncResult.value);
        }
    });
}

Support details

A capital Y in the following matrix indicates that this method is supported in the corresponding Office host application. An empty cell indicates that the Office host application doesn't support this method.

For more information about Office host application and server requirements, see Requirements for running Office Add-ins.

Supported hosts, by platform

Support history