parameter, élément

Article
07/22/2023

L’élément de paramètre facultatif spécifie une chaîne de texte qui est remplacée par un caractère de pourcentage (%) dans le texte d’un message de notification d’événement.

L’élément parameter 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

<parameter
  stringID = "xs:string"
  resourceDll = "xs:string"
  type = "xs:string"/>

Attributs

Attribut	Type	Obligatoire	Description
resourceDll	xs:string	No	Attribut facultatif qui spécifie une DLL de ressource qui contient le texte à 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 à l’emplacement du caractère pourcentage (%) dans le texte 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.
type	xs:string	No	Attribut facultatif qui spécifie le nom de l’imprimante ou du document. Cet attribut peut prendre l’une des valeurs suivantes : DocumentNom du document en cours d’impression. PrinterNameLe nom de l’imprimante, comme indiqué dans le dossier Imprimantes et télécopies dans Panneau de configuration, par exemple, « Fabrikam 5000 on \printserver » ou « Imprimante dans la chambre à l’étage ».

Éléments enfants

Il n’y a pas d’éléments enfants.

Éléments parents

Élément	Description
body	Élément obligatoire qui fournit du 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.
Titre	L’élément title requis fournit le texte affiché dans le titre du message de notification d’événement.

Remarques

Le texte chargé à partir de la DLL de ressource peut contenir des pourcentages (%) caractères qui seront remplacés par des chaînes de texte spécifiées par l’élément de paramètre .

Exemples

L’exemple de code suivant montre comment l’élément de paramètre peut être utilisé pour générer un message de notification d’événement complet.

Dans cet exemple, les valeurs stringID spécifient les éléments suivants :

La chaîne d’interface utilisateur 100 dans la DLL de ressource de pilote est « L’imprimante est hors de %1 encre ; ouvrez %2 et remplacez la cartouche d’encre. »
La chaîne d’interface utilisateur 5 dans la DLL d’interface utilisateur fournie par Microsoft est « jaune ».
La chaîne d’interface utilisateur 1002 dans la DLL de ressource de pilote est « Side Access Door B ».

<?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>

Avec le code XML précédent, le corps du texte suivant (stringID="100 ») s’affiche dans le message de notification d’événement : « L’imprimante est hors encre jaune ; ouvrez la porte d’accès latérale B et remplacez la cartouche d’encre. »

Voir aussi

body

title

Partager via