Office.DisplayedSubject 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 l’objet 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 l’objet 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 l’objet 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 l’objet 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, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Paramètres

data

string

Chaîne à afficher temporairement dans l’objet d’un message. La chaîne est limitée à 255 caractères.

options
Office.AsyncContextOptions

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.

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 setAsync l’exécution s’exécutent simultanément, le contenu défini par le dernier complément qui termine l’opération setAsync s’affiche dans le champ d’objet.

  • 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 avoir appelé setAsync, l’objet d’origine 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 l’objet 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 l’objet d’un message. La chaîne est limitée à 255 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 setAsync l’exécution s’exécutent simultanément, le contenu défini par le dernier complément qui termine l’opération setAsync s’affiche dans le champ d’objet.

  • 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 avoir appelé setAsync, l’objet d’origine 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 subject field 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 subjectText = (document.getElementById("subject-text-field") as HTMLInputElement).value;
Office.context.mailbox.item.display.subject.setAsync(subjectText, (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 subject field.");
});