Office.DisplayedBody interface

Paquet:
outlook

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Fournit une méthode permettant de définir temporairement le contenu affiché dans le corps d’un message en mode Lecture.

Remarques

Jeu d’API : préversion de boîte aux lettres

Niveau d’autorisation minimal : lecture/écriture d’élément

Mode Outlook applicable : Message lu

Utilisateur

Méthodes

setAsync(data, options, callback)

Définit temporairement le contenu affiché dans le corps d’un message en mode Lecture. Le contenu défini reste visible jusqu’à ce que l’utilisateur passe à un autre message ou ferme la fenêtre du message actif.
setAsync(data, callback)

Définit temporairement le contenu affiché dans le corps d’un message en mode Lecture. Le contenu défini reste visible jusqu’à ce que l’utilisateur passe à un autre message ou ferme la fenêtre du message actif.

Détails de la méthode

setAsync(data, options, callback)

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Définit temporairement le contenu affiché dans le corps d’un message en mode Lecture. Le contenu défini reste visible jusqu’à ce que l’utilisateur passe à un autre message ou ferme la fenêtre du message actif.

setAsync(data: string, options: Office.AsyncContextOptions & CoercionTypeOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Paramètres

data

string

Chaîne à afficher temporairement dans le corps d’un message. Elle est limitée à un million de caractères.

options

Office.AsyncContextOptions & Office.CoercionTypeOptions

Un littéral d’objet qui contient une ou plusieurs des propriétés suivantes :- asyncContext: Les développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel. coercionType : format des données à afficher temporairement. La chaîne du paramètre data est convertie dans ce format.

callback

(asyncResult: Office.AsyncResult<void>) => void

Facultatif. Lorsque la méthode est terminée, la fonction passée dans le callback paramètre est appelée avec un seul paramètre, asyncResult, qui est un Office.AsyncResult objet. Les erreurs rencontrées seront indiquées dans la propriété asyncResult.error.

Retours

void

Remarques

Jeu d’API : préversion de boîte aux lettres

Niveau d’autorisation minimal : lecture/écriture d’élément

Mode Outlook applicable : Message lu

Recommandé : appelez Office.context.mailbox.item.body.getTypeAsync, puis transmettez la valeur renvoyée au options.coercionType paramètre.

Important:

  • Si plusieurs compléments qui implémentent s’exécutent setAsync simultanément, le contenu défini par le dernier complément qui termine l’opération setAsync s’affiche dans le corps.

  • Le contenu défini par la méthode s’affiche setAsync uniquement lorsque l’utilisateur visualise l’élément. Il n’est pas mis en cache dans Outlook et ne se synchronise pas avec d’autres clients Outlook.

  • Si vous enregistrez un message après l’appel setAsync, le contenu d’origine du corps du message apparaît dans l’élément enregistré.

  • La setAsync méthode n’est pas prise en charge sur les messages sélectionnés multiples.

setAsync(data, callback)

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Définit temporairement le contenu affiché dans le corps d’un message en mode Lecture. Le contenu défini reste visible jusqu’à ce que l’utilisateur passe à un autre message ou ferme la fenêtre du message actif.

setAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Paramètres

data

string

Chaîne à afficher temporairement dans le corps d’un message. Elle est limitée à un million de caractères.

callback

(asyncResult: Office.AsyncResult<void>) => void

Facultatif. Lorsque la méthode est terminée, la fonction passée dans le callback paramètre est appelée avec un seul paramètre, asyncResult, qui est un Office.AsyncResult objet. Les erreurs rencontrées seront indiquées dans la propriété asyncResult.error.

Retours

void

Remarques

Jeu d’API : préversion de boîte aux lettres

Niveau d’autorisation minimal : lecture/écriture d’élément

Mode Outlook applicable : Message lu

Important:

  • Si plusieurs compléments qui implémentent s’exécutent setAsync simultanément, le contenu défini par le dernier complément qui termine l’opération setAsync s’affiche dans le corps.

  • Le contenu défini par la méthode s’affiche setAsync uniquement lorsque l’utilisateur visualise l’élément. Il n’est pas mis en cache dans Outlook et ne se synchronise pas avec d’autres clients Outlook.

  • Si vous enregistrez un message après l’appel setAsync, le contenu d’origine du corps du message apparaît dans l’élément enregistré.

  • La setAsync méthode n’est pas prise en charge sur les messages sélectionnés multiples.

Exemples

// 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 = (document.getElementById("body-text-field") as HTMLInputElement).value;
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.");
});