Office.CoercionType enum

Especifica como forçar dados retornados ou definidos pelo método invocado.

Comentários

O suporte de aplicativo e plataforma para cada CoercionType um é especificado nas descrições do conjunto de requisitos a seguir.

Exemplos

// 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

Retorna ou define dados como HTML.

Observação: só se aplica a dados em suplementos para suplementos de Word e outlook para Outlook (modo de composição).

Image

Os dados são retornados ou definidos como um fluxo de imagem. Observação: só se aplica a dados no Excel, Word e PowerPoint.

Matrix

Retornar ou definir dados como dados tabulares sem nenhum cabeçalho. Os dados são retornados ou definidos como uma matriz de matrizes contendo execuções de caracteres unidimensionais. Por exemplo, três linhas de valores de cadeia de caracteres em duas colunas seriam: [["R1C1", "R1C2"], ["R2C1", "R2C2"], ["R3C1", "R3C2"]].

Observação: só se aplica a dados no Excel e Word.

Ooxml

Retorna ou define dados como Office Open XML.

Observação: só se aplica a dados em Word.

SlideRange

Retorne um objeto JSON que contém uma matriz de IDs, títulos e índices dos slides selecionados. Por exemplo, {"slides":[{"id":257,"title":"Slide 2","index":2},{"id":256,"title":"Slide 1","index":1}]} para uma seleção de dois slides.

Observação: só se aplica aos dados no PowerPoint ao chamar o método Document.getSelectedData para obter o slide atual ou o intervalo selecionado de slides.

Table

Retorna ou define dados como dados tabulares com cabeçalhos opcionais. Os dados são retornados ou definidos como uma matriz de matrizes com cabeçalhos opcionais.

Observação: só se aplica a dados no Excel e Word.

Text

Retornar ou definir dados como texto (cadeia de caracteres). Os dados são retornados ou definidos como uma execução unidimensional de caracteres.

XmlSvg

Os dados são retornados ou definidos como dados XML que contêm uma imagem SVG. Observação: só se aplica a dados no Excel, Word e PowerPoint.