Office.CoercionType enum

Указывает способ приведения данных, возвращаемых или задаваемых вызванным методом.

Комментарии

Поддержка приложений и платформ для каждого из них CoercionType указана в следующих описаниях набора обязательных элементов.

  • HtmlCoercion, (при использовании Office.CoercionType.Html)

  • ImageCoercion 1.1 (при использовании Office.CoercionType.Image)

  • MatrixCoercion (при использовании Office.CoercionType.Matrix)

  • OoxmlCoercion (при использовании Office.CoercionType.Ooxml)

  • Selection

  • TableCoercion (при использовании Office.CoercionType.Table)

  • TextCoercion (при использовании Office.CoercionType.Text)

  • ImageCoercion 1.2 (при использовании Office.CoercionType.XmlSvg)

Примеры

// This function displays the currently selected text in the console.
// It uses the Common APIs.
function run() {
    Office.context.document.getSelectedDataAsync(Office.CoercionType.Text, (asyncResult) => {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            console.error(asyncResult.error.message);
        } else {
            console.log(`The selected data is "${asyncResult.value}".`);
        }
    });
}

Поля

Html

Возвращает или задает данные в формате HTML.

Примечание. Применяется только к данным в надстройках для Word и Outlook для Outlook (режим создания).

Image

Данные возвращаются или задаются как поток образа. Примечание. Применяется только к данным в Excel, Word и PowerPoint.

Matrix

Возвращает или задает данные в табличном формате без заголовков. Данные возвращаются или задаются как массив массивов с одномерными последовательностями символов. Например, три строки строковых значений в двух столбцах: [["R1C1", "R1C2"], ["R2C1", "R2C2"], ["R3C1", "R3C2"]].

Примечание. Применяется только к данным в Excel и Word.

Ooxml

Возвращает или задает данные в формате Office Open XML.

Примечание. Применяется только к данным в Word.

SlideRange

Возвращает объект JSON, содержащий массив идентификаторов, заголовков и индексов выбранных слайдов. Например, {"slides":[{"id":257,"title":"Slide 2","index":2},{"id":256,"title":"Slide 1","index":1}]} для выбора из двух слайдов.

Примечание. Применяется только к данным в PowerPoint при вызове метода Document.getSelectedData для получения текущего слайда или выбранного диапазона слайдов.

Table

Возвращает или задает данные в табличном формате с необязательными заголовками. Данные возвращаются или задаются в качестве массива массивов с необязательными заголовками.

Примечание. Применяется только к данным в Excel и Word.

Text

Возврат или установка данных в виде текста (строки). Данные возвращаются или задаются в виде одномерной последовательности символов.

XmlSvg

Данные возвращаются или задаются как XML-данные, содержащие изображение SVG. Примечание. Применяется только к данным в Excel, Word и PowerPoint.