Office.CoercionType enum

Paket:

office

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.

• HtmlCoercion, (bei Verwendung von Office.CoercionType.Html)

• ImageCoercion 1.1 (bei Verwendung von Office.CoercionType.Image)

• MatrixCoercion (bei Verwendung von Office.CoercionType.Matrix)

• OoxmlCoercion (bei Verwendung von Office.CoercionType.Ooxml)

• Selection

• TableCoercion (bei Verwendung von Office.CoercionType.Table)

• TextCoercion (bei Verwendung von Office.CoercionType.Text)

• ImageCoercion 1.2 (bei Verwendung von Office.CoercionType.XmlSvg)

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 = "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 = "image"	Daten werden als Bilddatenstrom zurückgegeben oder festgelegt. Hinweis: Gilt nur für Daten in Excel, Word und PowerPoint.
Matrix = "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 = "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 = "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.getSelectedDataAsync-Methode aufgerufen wird, um die aktuelle Folie oder den ausgewählten Folienbereich abzurufen.
Table = "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 = "text"	Zurückgeben oder Festlegen von Daten als Text (Zeichenfolge). Daten werden als eindimensionale Zeichenfolge zurückgegeben oder festgelegt.
XmlSvg = "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.