élément body

Article
02/07/2024

L’élément body requis fournit le texte affiché dans le message de notification d’événement. Ce texte doit fournir des détails spécifiques à l’utilisateur sur l’événement d’imprimante.

L’élément body est défini dans l’espace de noms asyncui à cet URI :

https://schemas.microsoft.com/2003/print/asyncui/v1/request

Cette ressource n’est peut-être pas disponible dans certaines langues et certains pays.

Utilisation

<body
  stringID = "xs:string"
  resourceDll = "xs:string">
  child elements
</body>

Attributs

Attribut	Type	Obligatoire	Description
resourceDll	xs:string	No	Attribut facultatif qui spécifie une DLL de ressource qui contient le texte du corps à afficher dans le message de notification d’événement. Cette DLL doit être un fichier dépendant du pilote d’imprimante et doit être présent dans le dossier de ressources du pilote (par exemple, %SYSTEMROOT%\system32\spool\drivers\w32x86\3).
stringID	xs:string	Yes	Attribut obligatoire qui spécifie le texte à afficher dans le corps du message de notification d’événement. La valeur de l’attribut spécifie l’emplacement de la chaîne de texte dans la DLL de ressource.

Éléments enfants

Élément	Description
Paramètre	Élément facultatif qui spécifie des chaînes de texte qui remplacent les paramètres d’une spécification de corps de texte.

Éléments parents

Élément	Description
balloonUI	Élément facultatif utilisé pour afficher une bulle de message sur l’ordinateur client.
messageBoxUI	Élément facultatif utilisé pour afficher une boîte de message sur l’ordinateur client.

Remarques

Le corps de texte chargé à partir de la DLL de ressource peut contenir des balises de pourcentage (%) qui seront remplacées par des chaînes de texte spécifiées par l’élément enfant du paramètre .

Plusieurs balises de corps peuvent être utilisées séquentiellement, auquel cas le texte généré par chacune d’elles est concaténé dans le message de notification d’événement. Un espace est inséré entre chaque paire de chaînes de texte. Le même message de notification peut afficher à la fois : status informations, telles que « Votre imprimante est hors entrée manuscrite », et des instructions pour l’utilisateur, telles que « Remplacez la cartouche d’encre et appuyez sur le bouton Reprendre sur l’imprimante pour continuer ».

Le texte contenu dans l’élément body doit indiquer à l’utilisateur quelle action est disponible.

Utilisez les recommandations suivantes pour que le texte du message reste utile et concis :

Utilisez des phrases complètes avec une ponctuation de fin.
Composer un corps de texte qui peut comporter moins de 255 caractères lorsqu’il est localisé dans d’autres langues. Par exemple, un message en anglais ne doit généralement pas utiliser plus de 200 caractères afin de prendre en charge la localisation dans d’autres langues.
Incluez des informations essentielles qui permettent à l’utilisateur d’effectuer une action demandée, telles que des noms d’objets spécifiques, des noms d’utilisateur, des noms de fichiers ou des URL spécifiques. Les utilisateurs ne doivent pas avoir à ouvrir une autre fenêtre pour trouver ces informations.
Placez des guillemets doubles autour des noms d’objets (par exemple, « Papier bac 1 »). Toutefois, n’utilisez pas de guillemets lorsque le nom de l’objet utilise des mots en majuscules, comme un nom d’utilisateur, qu’il est décalé avec un signe deux-points (par exemple, Nom de l’imprimante : Mon imprimante), ou qu’il peut être facilement déterminé à partir du contexte.
Si vous devez tronquer les noms d’objets à une taille maximale fixe pour prendre en charge la localisation, utilisez des points de suspension (...) pour indiquer la troncation.
Si un message de notification fournit un bouton pour l’action de l’utilisateur, vérifiez qu’il existe deux sauts de ligne entre les informations du message et le bouton. Étiquetez le bouton avec des expressions simples orientées action, telles que « Cliquer pour redémarrer l’impression » ou « Cliquer pour afficher plus d’informations ».
Utilisez uniquement les messages de notification pour les informations non critiques que l’utilisateur peut librement ignorer. Le corps du texte ne doit pas indiquer que l’utilisateur doit effectuer une action.
Si l’utilisateur doit effectuer une action, décrivez clairement l’importance et les conséquences de l’exécution de l’action.
Décrivez les problèmes en langage simple avec des informations spécifiques sur la façon dont l’utilisateur peut les résoudre.
Décrire l’événement d’une manière pertinente pour l’utilisateur. Un message de notification est pertinent s’il existe une probabilité raisonnable qu’un utilisateur effectue une tâche ou modifie son comportement à la suite de la notification.
Décrire un événement en termes d’objectifs utilisateur, plutôt qu’en termes de problèmes technologiques.

Exemples

L’exemple de code suivant montre comment utiliser l’élément body .

<?xml version="1.0" ?>
   <asyncPrintUIRequest
    xmlns="https://schemas.microsoft.com/2003/print/asyncui/v1/request">
    <v1>
      <requestOpen>
        <balloonUI iconID="1" resourceDll="IHV.dll">
          <title stringID="1234" resourceDll="IHV.dll" />
          <body stringID="100" resourceDll="IHV.dll">
            <parameter stringID="5" />
            <parameter stringID="1002" resourceDll="IHV.dll" />
          </body>
        </balloonUI>
      </requestOpen>
    </v1>
  </asyncPrintUIRequest>

Voir aussi

balloonUI

messageBoxUI

Paramètre

Partager via