Freigeben über


Office.CoercionType enum

Gibt an, wie Daten umgewandelt werden sollen, die von der aufgerufenen Methode zurückgegeben oder festgelegt wurden.

Hinweise

Die Anwendungs- und Plattformunterstützung für jede CoercionType wird in den folgenden Beschreibungen des Anforderungssatzes angegeben.

Beispiele

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

Felder

Html

Gibt Daten als HTML zurück oder legt sie als HTML fest.

Hinweis: Gilt nur für Daten in Add-Ins für Word und Outlook-Add-Ins für Outlook (Verfassenmodus).

Image

Daten werden als Bilddatenstrom zurückgegeben oder festgelegt. Hinweis: Gilt nur für Daten in Excel, Word und PowerPoint.

Matrix

Gibt Daten tabellarisch und ohne Kopfzeilen zurück oder legt sie entsprechend fest. Daten werden als Array mit eindimensionalen Zeichenfolgen zurückgegeben oder festgelegt. Beispielsweise wären drei Zeilen mit Zeichenfolgenwerten in zwei Spalten: [["R1C1", "R1C2"], ["R2C1", "R2C2"], ["R3C1", "R3C2"]].

Hinweis: Gilt nur für Daten in Excel und Word.

Ooxml

Gibt Daten als Office Open XML zurück oder legt sie als Office Open XML fest.

Hinweis: Gilt nur für Daten in Word.

SlideRange

Gibt ein JSON-Objekt zurück, das ein Array der IDs, Titel und Indizes der ausgewählten Folien enthält. Beispielsweise {"slides":[{"id":257,"title":"Slide 2","index":2},{"id":256,"title":"Slide 1","index":1}]} für eine Auswahl von zwei Folien.

Hinweis: Gilt nur für Daten in PowerPoint, wenn die Document.getSelectedData-Methode aufgerufen wird, um die aktuelle Folie oder den ausgewählten Folienbereich abzurufen.

Table

Gibt Daten tabellarisch und mit optionalen Kopfzeilen zurück oder legt sie entsprechend fest. Daten werden als Array von Arrays mit optionalen Kopfzeilen zurückgegeben oder festgelegt.

Hinweis: Gilt nur für Daten in Excel und Word.

Text

Zurückgeben oder Festlegen von Daten als Text (Zeichenfolge). Daten werden als eindimensionale Zeichenfolge zurückgegeben oder festgelegt.

XmlSvg

Daten werden als XML-Daten zurückgegeben oder festgelegt, die ein SVG-Bild enthalten. Hinweis: Gilt nur für Daten in Excel, Word und PowerPoint.