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.
HtmlCoercion, (cuando se usa Office.CoercionType.Html)
// 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.
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.