Share via


Office.CoercionType enum

Especifica cómo convertir los datos que el método invocado ha devuelto o definido.

Comentarios

La compatibilidad con aplicaciones y plataformas para cada CoercionType una de ellas se especifica en las descripciones del conjunto de requisitos siguientes.

Ejemplos

// 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}".`);
        }
    });
}

Campos

Html

Devuelve o establece datos como HTML.

Nota: Solo se aplica a los datos de los complementos para Word y los complementos de Outlook para Outlook (modo de redacción).

Image

Los datos se devuelven o establecen como una secuencia de imagen. Nota: Solo se aplica a los datos de Excel, Word y PowerPoint.

Matrix

Devuelve o establece datos como datos tabulares sin ningún encabezado. Los datos se devuelven o se establecen como una matriz de matrices que contiene series unidimensionales de caracteres. Por ejemplo, tres filas de valores de cadena en dos columnas serían: [["R1C1", "R1C2"], ["R2C1", "R2C2"], ["R3C1", "R3C2"]].

Nota: Solo se aplica a los datos de Excel y Word.

Ooxml

Devuelve o establece los datos como Office Open XML.

Nota: Solo se aplica a los datos de Word.

SlideRange

Devuelve un objeto JSON que contiene una matriz de identificadores, títulos e índices de las diapositivas seleccionadas. Por ejemplo, {"slides":[{"id":257,"title":"Slide 2","index":2},{"id":256,"title":"Slide 1","index":1}]} para una selección de dos diapositivas.

Nota: Solo se aplica a los datos de PowerPoint al llamar al método Document.getSelectedData para obtener la diapositiva actual o el intervalo seleccionado de diapositivas.

Table

Devuelve o establece datos como datos tabulares con encabezados opcionales. Datos devueltos o establecidos como una matriz de matrices con encabezados opcionales.

Nota: Solo se aplica a los datos de Excel y Word.

Text

Devolver o establecer datos como texto (cadena). Los datos se devuelven o establecen como una ejecución unidimensional de caracteres.

XmlSvg

Los datos se devuelven o establecen como datos XML que contienen una imagen SVG. Nota: Solo se aplica a los datos de Excel, Word y PowerPoint.