Office.CoercionType enum

包:

office

指定如何强制由调用方法返回或设置的数据。

注解

以下要求集说明中指定了每个 CoercionType 应用程序和平台支持。

• HtmlCoercion，使用 Office.CoercionType.Html) 时 (

• 使用 Office.CoercionType.Image) 时 imageCoercion 1.1 (

• 使用 Office.CoercionType.Matrix) 时，MatrixCoercion (

• 使用 Office.CoercionType.Ooxml) 时 OoxmlCoercion (

• Selection

• 使用 Office.CoercionType.Table) 时的 TableCoercion (

• 使用 Office.CoercionType.Text) 时 TextCoercion (

• 使用 Office.CoercionType.XmlSvg) 时 imageCoercion 1.2 (

示例

// 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 对象，该对象包含所选幻灯片的 ID、标题和索引数组。 例如， {"slides":[{"id":257,"title":"Slide 2","index":2},{"id":256,"title":"Slide 1","index":1}]} 对于选择两张幻灯片。 注意：仅当调用 Document.getSelectedData 方法以获取当前幻灯片或所选幻灯片范围时，才应用于 PowerPoint 中的数据。
Table	以带可选标题的表格数据形式返回或设置的数据。 以具有可选标题的数组的数组形式返回或设置数据。 注意：仅适用于 Excel 和 Word 中的数据。
Text	以文本 (字符串) 返回或设置数据。 以一维连续文本的字符形式返回或设置的数据。
XmlSvg	数据返回或设置为包含 SVG 图像的 XML 数据。 注意：仅适用于 Excel、Word和 PowerPoint 中的数据。