Office.Body interface

L’objet body fournit des méthodes pour ajouter et mettre à jour le contenu du message ou du rendez-vous. Il est renvoyé dans la propriété body de l’élément sélectionné.

Remarques

[Ensemble d’API : Mailbox 1.1 ]

Problème connu avec les couleurs de bordure de tableau HTML

Outlook sur Windows : si vous devez définir différentes bordures de cellule sur différentes couleurs dans un tableau HTML en mode Composition, les bordures d’une cellule risquent de ne pas refléter la couleur attendue. Pour connaître le comportement connu, consultez le problème OfficeDev/office-js # 1818.

Niveau d’autorisation minimal :ReadItem

Mode Outlook applicable  : Rédiger ou Lire

Méthodes

getAsync(coercionType, options, callback)

Renvoie le corps actif dans un format spécifié.

Cette méthode renvoie l’intégralité du corps actuel au format spécifié par coercionType.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que les méthodes et les méthodes ne sont Body.getAsync Body.setAsync pas idempotentes. La valeur renvoyée par la méthode ne sera pas nécessairement identique à celle qui a été passée précédemment getAsync dans setAsync la méthode. Le client peut modifier la valeur transmise afin de le rendre setAsync efficacement avec son moteur de rendu.

getAsync(coercionType, callback)

Renvoie le corps actif dans un format spécifié.

Cette méthode renvoie l’intégralité du corps actuel au format spécifié par coercionType.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que les méthodes et les méthodes ne sont Body.getAsync Body.setAsync pas idempotentes. La valeur renvoyée par la méthode ne sera pas nécessairement identique à celle qui a été passée précédemment getAsync dans setAsync la méthode. Le client peut modifier la valeur transmise afin de le rendre setAsync efficacement avec son moteur de rendu.

getTypeAsync(options, callback)

Obtient une valeur qui indique si le contenu est au format HTML ou texte.

getTypeAsync(callback)

Obtient une valeur qui indique si le contenu est au format HTML ou texte.

prependAsync(data, options, callback)

Ajoute le contenu spécifié au début du corps de l’élément.

La méthode prependAsync insère la chaîne spécifiée au début du corps de l’élément. Après l’insertion, le curseur est renvoyé à son endroit d’origine, par rapport au contenu inséré.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que le client peut modifier la valeur transmise afin de la rendre plus efficace avec son moteur prependAsync de rendu. Cela signifie que la valeur renvoyée par un appel ultérieur à la méthode (introduite dans Body.getAsync Mailbox 1.3) ne contiendra pas nécessairement exactement la valeur qui a été passée précédemment dans la prependAsync méthode.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en attribuant l’attribut id au point d’ancrage (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

prependAsync(data, callback)

Ajoute le contenu spécifié au début du corps de l’élément.

La méthode prependAsync insère la chaîne spécifiée au début du corps de l’élément. Après l’insertion, le curseur est renvoyé à son endroit d’origine, par rapport au contenu inséré.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que le client peut modifier la valeur transmise afin de la rendre plus efficace avec son moteur prependAsync de rendu. Cela signifie que la valeur renvoyée par un appel ultérieur à la méthode (introduite dans Body.getAsync Mailbox 1.3) ne contiendra pas nécessairement exactement la valeur qui a été passée précédemment dans la prependAsync méthode.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en attribuant l’attribut id au point d’ancrage (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

setAsync(data, options, callback)

Remplace l’ensemble du corps avec le texte spécifié.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que les méthodes et les méthodes ne sont Body.getAsync Body.setAsync pas idempotentes. La valeur renvoyée par la méthode ne sera pas nécessairement identique à celle qui a été passée précédemment getAsync dans setAsync la méthode. Le client peut modifier la valeur transmise afin de le rendre setAsync efficacement avec son moteur de rendu.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en attribuant l’attribut id au point d’ancrage (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

Important: dans Outlook sur Windows et sur Mac, l’utilisateur du add-in ne peut pas annuler cette action avec la commande Annuler.

setAsync(data, callback)

Remplace l’ensemble du corps avec le texte spécifié.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que les méthodes et les méthodes ne sont Body.getAsync Body.setAsync pas idempotentes. La valeur renvoyée par la méthode ne sera pas nécessairement identique à celle qui a été passée précédemment getAsync dans setAsync la méthode. Le client peut modifier la valeur transmise afin de le rendre setAsync efficacement avec son moteur de rendu.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en attribuant l’attribut id au point d’ancrage (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

Important: dans Outlook sur Windows et sur Mac, l’utilisateur du add-in ne peut pas annuler cette action avec la commande Annuler.

setSelectedDataAsync(data, options, callback)

Remplace la sélection dans le corps par le texte spécifié.

La méthode setSelectedDataAsync insère la chaîne spécifiée à l’emplacement du curseur dans le corps de l’élément ou, si du texte est sélectionné dans l’éditeur, elle remplace ce texte. Si le curseur ne s’est jamais trouvé dans le corps de l’élément, ou si le corps de l’élément n’est plus la partie active de l’interface utilisateur, la chaîne est insérée au début du corps de l’élément. Après l’insertion, le curseur est placé à la fin du contenu inséré.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en setting the id attribute on the anchor (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

setSelectedDataAsync(data, callback)

Remplace la sélection dans le corps par le texte spécifié.

La méthode setSelectedDataAsync insère la chaîne spécifiée à l’emplacement du curseur dans le corps de l’élément ou, si du texte est sélectionné dans l’éditeur, elle remplace ce texte. Si le curseur ne s’est jamais trouvé dans le corps de l’élément, ou si le corps de l’élément n’est plus la partie active de l’interface utilisateur, la chaîne est insérée au début du corps de l’élément. Après l’insertion, le curseur est placé à la fin du contenu inséré.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en setting the id attribute on the anchor (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

Détails de la méthode

getAsync(coercionType, options, callback)

Renvoie le corps actif dans un format spécifié.

Cette méthode renvoie l’intégralité du corps actuel au format spécifié par coercionType.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que les méthodes et les méthodes ne sont Body.getAsync Body.setAsync pas idempotentes. La valeur renvoyée par la méthode ne sera pas nécessairement identique à celle qui a été passée précédemment getAsync dans setAsync la méthode. Le client peut modifier la valeur transmise afin de le rendre setAsync efficacement avec son moteur de rendu.

getAsync(coercionType: Office.CoercionType | string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;

Paramètres

coercionType

Office.CoercionType | string

Format du corps renvoyé.

options
Office.AsyncContextOptions

Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : asyncContext: les développeurs peuvent fournir n’importe quel objet à accéder dans la méthode de rappel.

callback

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

Facultatif. Une fois la méthode terminée, la fonction passée dans le paramètre est appelée avec un seul paramètre callback de type Office. AsyncResult. Le corps est fourni au format demandé dans la asyncResult.value propriété.

Retours

void

Remarques

[Ensemble d’API : Mailbox 1.3 ]

Niveau d’autorisation minimal :ReadItem

Mode Outlook applicable  : Rédiger ou Lire

Exemples

// This example gets the body of the item as plain text.
Office.context.mailbox.item.body.getAsync(
    "text",
    { asyncContext: "This is passed to the callback" },
    function callback(result) {
        // Do something with the result.
    });

// The following is an example of the result parameter passed to the callback function.
{
    "value": "TEXT of whole body (including threads below)",
    "status": "succeeded",
    "asyncContext": "This is passed to the callback"
}

getAsync(coercionType, callback)

Renvoie le corps actif dans un format spécifié.

Cette méthode renvoie l’intégralité du corps actuel au format spécifié par coercionType.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que les méthodes et les méthodes ne sont Body.getAsync Body.setAsync pas idempotentes. La valeur renvoyée par la méthode ne sera pas nécessairement identique à celle qui a été passée précédemment getAsync dans setAsync la méthode. Le client peut modifier la valeur transmise afin de le rendre setAsync efficacement avec son moteur de rendu.

getAsync(coercionType: Office.CoercionType | string, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;

Paramètres

coercionType

Office.CoercionType | string

Format du corps renvoyé.

callback

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

Facultatif. Une fois la méthode terminée, la fonction passée dans le paramètre est appelée avec un seul paramètre callback de type Office. AsyncResult. Le corps est fourni au format demandé dans la asyncResult.value propriété.

Retours

void

Remarques

[Ensemble d’API : Mailbox 1.3 ]

Niveau d’autorisation minimal :ReadItem

Mode Outlook applicable  : Rédiger ou Lire

getTypeAsync(options, callback)

Obtient une valeur qui indique si le contenu est au format HTML ou texte.

getTypeAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<Office.CoercionType>) => void): void;

Paramètres

options
Office.AsyncContextOptions

Littéral d’objet contenant une ou plusieurs des propriétés suivantes. asyncContext: les développeurs peuvent fournir n’importe quel objet à accéder dans la méthode de rappel.

callback

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

Facultatif. Une fois la méthode terminée, la fonction passée dans le paramètre est appelée avec callback un seul paramètre de type Office.AsyncResult. Le type de contenu est renvoyé en tant que l’une des CoercionType valeurs de la asyncResult.value propriété.

Retours

void

Remarques

[Ensemble d’API : Mailbox 1.1 ]

Niveau d’autorisation minimal :ReadItem

Mode Outlook applicable : Composer

Exemples

Office.context.mailbox.item.body.getTypeAsync(function (asyncResult) {
    if (asyncResult.status === "failed") {
        console.log("Action failed with error: " + asyncResult.error.message);
    } else {
        console.log("Body type: " + asyncResult.value);
    }
});

getTypeAsync(callback)

Obtient une valeur qui indique si le contenu est au format HTML ou texte.

getTypeAsync(callback?: (asyncResult: Office.AsyncResult<Office.CoercionType>) => void): void;

Paramètres

callback

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

Facultatif. Une fois la méthode terminée, la fonction passée dans le paramètre est appelée avec callback un seul paramètre de type Office.AsyncResult. Le type de contenu est renvoyé en tant que l’une des CoercionType valeurs de la asyncResult.value propriété.

Retours

void

Remarques

[Ensemble d’API : Mailbox 1.1 ]

Niveau d’autorisation minimal :ReadItem

Mode Outlook applicable : Composer

prependAsync(data, options, callback)

Ajoute le contenu spécifié au début du corps de l’élément.

La méthode prependAsync insère la chaîne spécifiée au début du corps de l’élément. Après l’insertion, le curseur est renvoyé à son endroit d’origine, par rapport au contenu inséré.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que le client peut modifier la valeur transmise afin de la rendre plus efficace avec son moteur prependAsync de rendu. Cela signifie que la valeur renvoyée par un appel ultérieur à la méthode (introduite dans Body.getAsync Mailbox 1.3) ne contiendra pas nécessairement exactement la valeur qui a été passée précédemment dans la prependAsync méthode.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en attribuant l’attribut id au point d’ancrage (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

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

Paramètres

data

string

La chaîne doit être insérée au début du corps. Elle est limitée à un million de caractères.

options

Office.AsyncContextOptions & Office.CoercionTypeOptions

Littéral d’objet contenant une ou plusieurs des propriétés suivantes. asyncContext: les développeurs peuvent fournir n’importe quel objet à accéder dans la méthode de rappel. coercionType: format souhaité pour le corps. La chaîne du paramètre data est convertie dans ce format.

callback

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

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

Retours

void

Remarques

[Ensemble d’API : Mailbox 1.1 ]

Niveau d’autorisation minimal :ReadWriteItem

Mode Outlook applicable : Composer

Erreurs:

  • DataExceedsMaximumSize: le paramètre de données est plus de 1 000 000 caractères.

Exemples

// When including links in HTML markup, you can disable online link preview
// by setting the id attribute on the anchor (<a>) to "LPNoLP".
Office.context.mailbox.item.body.prependAsync(
    '<a id="LPNoLP" href="http://www.contoso.com">Click here!</a>',
    {coercionType: Office.CoercionType.Html},
    callback);

prependAsync(data, callback)

Ajoute le contenu spécifié au début du corps de l’élément.

La méthode prependAsync insère la chaîne spécifiée au début du corps de l’élément. Après l’insertion, le curseur est renvoyé à son endroit d’origine, par rapport au contenu inséré.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que le client peut modifier la valeur transmise afin de la rendre plus efficace avec son moteur prependAsync de rendu. Cela signifie que la valeur renvoyée par un appel ultérieur à la méthode (introduite dans Body.getAsync Mailbox 1.3) ne contiendra pas nécessairement exactement la valeur qui a été passée précédemment dans la prependAsync méthode.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en attribuant l’attribut id au point d’ancrage (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

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

Paramètres

data

string

La chaîne doit être insérée au début du corps. Elle est limitée à un million de caractères.

callback

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

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

Retours

void

Remarques

[Ensemble d’API : Mailbox 1.1 ]

Niveau d’autorisation minimal :ReadWriteItem

Mode Outlook applicable : Composer

Erreurs:

  • DataExceedsMaximumSize: le paramètre de données est plus de 1 000 000 caractères.

setAsync(data, options, callback)

Remplace l’ensemble du corps avec le texte spécifié.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que les méthodes et les méthodes ne sont Body.getAsync Body.setAsync pas idempotentes. La valeur renvoyée par la méthode ne sera pas nécessairement identique à celle qui a été passée précédemment getAsync dans setAsync la méthode. Le client peut modifier la valeur transmise afin de le rendre setAsync efficacement avec son moteur de rendu.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en attribuant l’attribut id au point d’ancrage (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

Important: dans Outlook sur Windows et sur Mac, l’utilisateur du add-in ne peut pas annuler cette action avec la commande Annuler.

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

Paramètres

data

string

Chaîne qui remplace le corps existant. Elle est limitée à 1 000 000 caractères.

options

Office.AsyncContextOptions & Office.CoercionTypeOptions

Littéral d’objet contenant une ou plusieurs des propriétés suivantes. asyncContext: les développeurs peuvent fournir n’importe quel objet à accéder dans la méthode de rappel. coercionType: format souhaité pour le corps. La chaîne du paramètre data est convertie dans ce format.

callback

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

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

Retours

void

Remarques

[Ensemble d’API : Mailbox 1.3 ]

Niveau d’autorisation minimal :ReadWriteItem

Mode Outlook applicable : Composer

Erreurs:

  • DataExceedsMaximumSize: le paramètre de données est plus de 1 000 000 caractères.

  • InvalidFormatError: le options.coercionType paramètre est paramétrable Office.CoercionType.Html et le corps du message est en texte simple.

Exemples

// When including links in HTML markup, you can disable online link preview
// by setting the id attribute on the anchor (<a>) to "LPNoLP".
Office.context.mailbox.item.body.setAsync(
    '<a id="LPNoLP" href="http://www.contoso.com">Click here!</a>',
    {coercionType: Office.CoercionType.Html},
    callback);
Office.context.mailbox.item.body.setAsync(
    "<b>(replaces all body, including threads you are replying to that may be on the bottom)</b>",
    { coercionType: "html", asyncContext: "This is passed to the callback" },
    function callback(result) {
        // Process the result.
});

// The following is an example of the result parameter passed to the callback function.
{
    "value":null,
    "status": "succeeded",
    "asyncContext": "This is passed to the callback"
}

setAsync(data, callback)

Remplace l’ensemble du corps avec le texte spécifié.

Lorsque vous travaillez avec des corps au format HTML, il est important de noter que les méthodes et les méthodes ne sont Body.getAsync Body.setAsync pas idempotentes. La valeur renvoyée par la méthode ne sera pas nécessairement identique à celle qui a été passée précédemment getAsync dans setAsync la méthode. Le client peut modifier la valeur transmise afin de le rendre setAsync efficacement avec son moteur de rendu.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en attribuant l’attribut id au point d’ancrage (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

Important: dans Outlook sur Windows et sur Mac, l’utilisateur du add-in ne peut pas annuler cette action avec la commande Annuler.

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

Paramètres

data

string

Chaîne qui remplace le corps existant. Elle est limitée à 1 000 000 caractères.

callback

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

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

Retours

void

Remarques

[Ensemble d’API : Mailbox 1.3 ]

Niveau d’autorisation minimal :ReadWriteItem

Mode Outlook applicable : Composer

Erreurs:

  • DataExceedsMaximumSize: le paramètre de données est plus de 1 000 000 caractères.

  • InvalidFormatError: le options.coercionType paramètre est paramétrable Office.CoercionType.Html et le corps du message est en texte simple.

setSelectedDataAsync(data, options, callback)

Remplace la sélection dans le corps par le texte spécifié.

La méthode setSelectedDataAsync insère la chaîne spécifiée à l’emplacement du curseur dans le corps de l’élément ou, si du texte est sélectionné dans l’éditeur, elle remplace ce texte. Si le curseur ne s’est jamais trouvé dans le corps de l’élément, ou si le corps de l’élément n’est plus la partie active de l’interface utilisateur, la chaîne est insérée au début du corps de l’élément. Après l’insertion, le curseur est placé à la fin du contenu inséré.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en setting the id attribute on the anchor (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

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

Paramètres

data

string

Chaîne qui remplace le corps existant. Elle est limitée à 1 000 000 caractères.

options

Office.AsyncContextOptions & Office.CoercionTypeOptions

Littéral d’objet contenant une ou plusieurs des propriétés suivantes. asyncContext: les développeurs peuvent fournir n’importe quel objet à accéder dans la méthode de rappel. coercionType: format souhaité pour le corps. La chaîne du paramètre data est convertie dans ce format.

callback

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

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

Retours

void

Remarques

[Ensemble d’API : Mailbox 1.1 ]

Niveau d’autorisation minimal :ReadWriteItem

Mode Outlook applicable : Composer

Erreurs:

  • DataExceedsMaximumSize: data le paramètre est plus de 1 000 000 caractères.

  • InvalidFormatError: le options.coercionType paramètre est paramétrable Office.CoercionType.Html et le corps du message est en texte simple.

Exemples

// When including links in HTML markup, you can disable online link preview
// by setting the id attribute on the anchor (<a>) to "LPNoLP".
Office.context.mailbox.item.body.setSelectedDataAsync(
    '<a id="LPNoLP" href="http://www.contoso.com">Click here!</a>',
    {coercionType: Office.CoercionType.Html},
    callback);

setSelectedDataAsync(data, callback)

Remplace la sélection dans le corps par le texte spécifié.

La méthode setSelectedDataAsync insère la chaîne spécifiée à l’emplacement du curseur dans le corps de l’élément ou, si du texte est sélectionné dans l’éditeur, elle remplace ce texte. Si le curseur ne s’est jamais trouvé dans le corps de l’élément, ou si le corps de l’élément n’est plus la partie active de l’interface utilisateur, la chaîne est insérée au début du corps de l’élément. Après l’insertion, le curseur est placé à la fin du contenu inséré.

Lorsque vous insérez des liens dans le code HTML, vous pouvez désactiver l’aperçu de lien en ligne en setting the id attribute on the anchor (<a>) à « LPNoLP » (voir la section Exemples pour un exemple).

Recommandé : getTypeAsync l’appel passe ensuite la valeur renvoyée au options.coercionType paramètre.

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

Paramètres

data

string

Chaîne qui remplace le corps existant. Elle est limitée à 1 000 000 caractères.

callback

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

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

Retours

void

Remarques

[Ensemble d’API : Mailbox 1.1 ]

Niveau d’autorisation minimal :ReadWriteItem

Mode Outlook applicable : Composer

Erreurs:

  • DataExceedsMaximumSize: data le paramètre est plus de 1 000 000 caractères.

  • InvalidFormatError: le options.coercionType paramètre est paramétrable Office.CoercionType.Html et le corps du message est en texte simple.