Office.DisplayedBody interface
Hinweis
Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.
Stellt eine Methode bereit, um den im Textkörper einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus festzulegen.
Hinweise
[ API-Satz: Postfachvorschau ]
Minimale Berechtigungsstufe: Element lesen/schreiben
Anwendbarer Outlook-Modus: Lesen von Nachrichten
Methoden
| set |
Legt den im Textkörper einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus fest. Der festgelegte Inhalt bleibt sichtbar, bis der Benutzer zu einer anderen Nachricht wechselt oder das Fenster der aktuellen Nachricht schließt. |
| set |
Legt den im Textkörper einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus fest. Der Festgelegtinhalt bleibt sichtbar, bis der Benutzer zu einer anderen Nachricht wechselt oder das Fenster der aktuellen Nachricht schließt. |
Details zur Methode
setAsync(data, options, callback)
Hinweis
Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.
Legt den im Textkörper einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus fest. Der festgelegte Inhalt bleibt sichtbar, bis der Benutzer zu einer anderen Nachricht wechselt oder das Fenster der aktuellen Nachricht schließt.
setAsync(data: string, options: Office.AsyncContextOptions & CoercionTypeOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;Parameter
- data
-
string
Die Zeichenfolge, die vorübergehend im Textkörper einer Nachricht angezeigt werden soll. Die Zeichenfolge ist auf 1.000.000 Zeichen begrenzt.
Ein Objektliteral, das eine oder mehrere der folgenden Eigenschaften enthält: asyncContextEntwickler können jedes Objekt bereitstellen, auf das sie in der Rückruffunktion zugreifen möchten. coercionType: Das Format der Daten, die vorübergehend angezeigt werden sollen. Der Zeichenfolge im data-Parameter wird in dieses Format konvertiert.
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter aufgerufen, asyncResult, der ein Office.AsyncResult -Objekt ist. Alle aufgetretenen Fehler werden in der asyncResult.error-Eigenschaft bereitgestellt.
Gibt zurück
void
Hinweise
[ API-Satz: Postfachvorschau ]
Minimale Berechtigungsstufe: Element lesen/schreiben
Anwendbarer Outlook-Modus: Lesen von Nachrichten
Empfohlen: Rufen Sie Office.context.mailbox.item.body.getTypeAsync auf, und übergeben Sie dann den zurückgegebenen Wert an den options.coercionType Parameter.
Wichtig:
Wenn mehrere Add-Ins, die implementieren
setAsync, gleichzeitig ausgeführt werden, wird der Inhalt des letzten Add-Ins, das densetAsyncVorgang abgeschlossen hat, im Text angezeigt.Der von der
setAsync-Methode festgelegte Inhalt wird nur angezeigt, während der Benutzer das Element anzeigt. Es wird nicht in Outlook zwischengespeichert und nicht mit anderen Outlook-Clients synchronisiert.Wenn Sie eine Nachricht nach dem Aufrufen
setAsyncvon speichern, wird der ursprüngliche Inhalt des Nachrichtentexts im gespeicherten Element angezeigt.Die
setAsync-Methode wird für mehrere ausgewählte Nachrichten nicht unterstützt.
setAsync(data, callback)
Hinweis
Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.
Legt den im Textkörper einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus fest. Der Festgelegtinhalt bleibt sichtbar, bis der Benutzer zu einer anderen Nachricht wechselt oder das Fenster der aktuellen Nachricht schließt.
setAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;Parameter
- data
-
string
Die Zeichenfolge, die vorübergehend im Textkörper einer Nachricht angezeigt werden soll. Die Zeichenfolge ist auf 1.000.000 Zeichen begrenzt.
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter aufgerufen, asyncResult, der ein Office.AsyncResult -Objekt ist. Alle aufgetretenen Fehler werden in der asyncResult.error-Eigenschaft bereitgestellt.
Gibt zurück
void
Hinweise
[ API-Satz: Postfachvorschau ]
Minimale Berechtigungsstufe: Element lesen/schreiben
Anwendbarer Outlook-Modus: Lesen von Nachrichten
Wichtig:
Wenn mehrere Add-Ins, die implementieren
setAsync, gleichzeitig ausgeführt werden, wird der Inhalt des letzten Add-Ins, das densetAsyncVorgang abgeschlossen hat, im Text angezeigt.Der von der
setAsync-Methode festgelegte Inhalt wird nur angezeigt, während der Benutzer das Element anzeigt. Es wird nicht in Outlook zwischengespeichert und nicht mit anderen Outlook-Clients synchronisiert.Wenn Sie eine Nachricht nach dem Aufrufen
setAsyncvon speichern, wird der ursprüngliche Inhalt des Nachrichtentexts im gespeicherten Element angezeigt.Die
setAsync-Methode wird für mehrere ausgewählte Nachrichten nicht unterstützt.
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/99-preview-apis/set-displayed-body-subject.yaml
// This snippet temporarily sets the content displayed in the body of a message in read mode.
// The set content will remain visible until the user switches to a different message in the Reading Pane or closes the window of the current message.
const bodyText = $("#body-text-field")
.val()
.toString();
Office.context.mailbox.item.display.body.setAsync(bodyText, (asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Failed) {
console.log(`Action failed with error: ${asyncResult.error.message}`);
return;
}
console.log("Temporarily set the content displayed in the body.");
});
Office Add-ins