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