Ewa.EwaControl.loadEwaAsync(fileID, divID, embedOptions, callback, userContext)

Дата последнего изменения: 9 марта 2015 г.

Область применения: apps for SharePoint | Excel Services | SharePoint Server 2013

Содержание
Возвращаемое значение
Замечания
Пример

Внедрение книги Microsoft Excel в элемент <div> на странице веб-узла.

var value = Ewa.EwaControl.loadEwaAsync(fileID, divID, embedOptions, callback, userContext);

Параметры

fileID

Обязательные string , который указывает расположение книги для внедрения.

divID

Обязательные string , задающее идентификатор элемента <div> в страницы, содержащей внедренной книги.

embedOptions

Необязательные object , которая содержит три дочерние объекты, которые задают именованный объект, набор параметров, внешний вид и набор параметров взаимодействия для внедренной книги. Если этот объект не передается в вызове loadEwaAsync, книги загружается с помощью параметров взаимодействия и внешний вид текста.

Как уже было сказано, объект, который вы создаете может включать два дочерних объектов, которые можно использовать для изменения внешнего вида и взаимодействия для внедренной книги. Задайте параметры оформления для внедренной книги с помощью свойства одного дочернего объекта. Задайте параметры взаимодействия для внедренной книги с помощью других дочернего объекта. Чтобы узнать, как создавать и использовать объект с помощью двух дочерних объектов, которые задать внешний вид и взаимодействия для внедренной книги, см в примере кода данного раздела. В следующих таблицах перечислены определенные свойства, которые используется для установки параметров внешнего вида и для установки параметров взаимодействия.

В следующей таблице приведены свойства, которые представляют параметры оформления для внедренной книги.

В таблице 1. Свойства для задания параметров внешнего вида на внедренной книги

В следующей таблице приведены свойства, которые представляют параметры взаимодействия для внедренной книги. По умолчанию каждого свойства, которое содержит значение boolean имеет значение true. Также свойству false скрывает пользовательский интерфейс для этого параметра.

В таблице 2. Свойства для задания интерактивность параметры на внедренной книги

callback

Указывает функцию, вызываемую после завершения асинхронной операции.

userContext

Объект, который позволяет участникам передавать состояние с помощью асинхронного вызова.

Возвращаемое значение

Отсутствуют.

Замечания

Метод loadEwaAsync позволяет встраивать Excel книги, которые хранятся на OneDrive на страницу веб-узла.

Для отображения и программной работы с рабочей книги на внешний веб-странице, необходимо создать и вставить код внедрения в HTML-код веб-страницу узла. Несмотря на то, что можно написать код для внедрения книги, писать код внедрения проще воспользоваться диалоговым окномEmbedOneDrive. Диалоговое окно внедрения позволяет Установка параметров книги внедрения и автоматически создавать код HTML и ECMAScript (JavaScript, JScript) для внедрения книги с параметрами, которые задают отображения и взаимодействия для книги. Код ECMAScript (JavaScript, JScript), созданных функцией диалогового окна Embed используется метод loadEwaAsync .

На рисунке 1. Диалоговое окно внедрения

Кроме того диалоговое окно внедрения предоставляет только надежный способ получить маркер файла для файла, которые хранятся на OneDrive.

Пример

В следующем примере кода показано, как использовать метод loadEwaAsync для внедрения книгу с именем Book1.xlsx в веб-страницу узла. Этот пример кода был создан с помощью диалогового окнаEmbedOneDrive.

<div id="myExcelDiv" style="width: 402px; height: 346px"></div>
<script type="text/javascript" src="http://r.office.microsoft.com/r/rlidExcelWLJS?v=1&kip=1"></script>
<script type="text/javascript">

// Use this file token to reference Book1.xlsx in the Excel APIs.
var fileToken = "SD206C5E037684EDE5!1119/2336345675664780773/";

// Run the Excel load handler on page load.
if (window.attachEvent) {
window.attachEvent("onload", loadEwaOnPageLoad);
} else {
window.addEventListener("DOMContentLoaded", loadEwaOnPageLoad, false);
}

function loadEwaOnPageLoad() {                               
var props = {
                  item: "LunchSales",
uiOptions: {
showGridlines: false,
showRowColumnHeaders: false,
showParametersTaskPane: false
},
interactivityOptions: {
allowTypingAndFormulaEntry: false,
allowParameterModification: false,
allowSorting: false,
allowFiltering: false,
allowPivotTableInteractivity: false
}
};

Ewa.EwaControl. loadEwaAsync(fileToken, "myExcelDiv", props, onEwaLoaded);
}

function onEwaLoaded(result) {

        if (asyncResult.getSucceeded())
        {
            // Use the AsyncResult.getEwaControl() method to get a reference to the EwaControl object
            ewa = asyncResult.getEwaControl();
            ewa.add_activeCellChanged(cellChanged);
        }
        else
        {
            alert("Async operation failed!");
        }
}
</script>

См. также

Справочные материалы

Ewa.EwaControl Object

Другие ресурсы

Использование API JavaScript служб Excel для работы с внедренными книгами Excel