Partager via


élément button

L’élément button requis spécifie les caractéristiques d’un bouton dans une boîte de message qui s’affiche sur l’ordinateur client.

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

<button
  stringID = "xs:string"
  resourceDll = "xs:string"
  buttonID = "xs:string"/>

Attributs

Attribut Type Obligatoire Description
buttonID xs:string Yes Attribut obligatoire qui spécifie la chaîne qui sera retournée au pilote d’imprimante lorsque l’utilisateur clique sur le bouton. Cet attribut peut prendre l’une des valeurs suivantes :

IDOK : un bouton portant le nom « OK » s’affiche dans la boîte de message. Lorsque l’utilisateur clique sur le bouton, la boîte de message retourne la chaîne « IDOK ».

IDCANCEL : un bouton portant le nom « CANCEL » s’affiche dans la boîte de message. Lorsque l’utilisateur clique sur le bouton, la boîte de message renvoie la chaîne « IDCANCEL ».
resourceDll xs:string No Attribut facultatif qui spécifie une DLL de ressource qui contient le texte à afficher sur le bouton. 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 sur le bouton. La valeur de l’attribut spécifie l’emplacement de la chaîne de texte dans la DLL de ressource.

Éléments enfants

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

Éléments parents

Élément Description
buttons Élément obligatoire qui spécifie un ou plusieurs boutons affichés dans la boîte de message de notification d’événement sur l’ordinateur client.

Remarques

Les boutons s’affichent en bas de la boîte de message.

Exemples

L’exemple de code suivant montre comment utiliser l’élément button pour afficher les boutons OK et CANCEL l’un à côté de l’autre.

<?xml version="1.0" ?>
  <asyncPrintUIRequest
    xmlns="https://schemas.microsoft.com/2003/print/asyncui/v1/request">
    <v1>
      <requestOpen>
        <messageBoxUI>
          <title stringID="1234" resourceDll="IHV.dll" />
          <body stringID="100" resourceDll="IHV.dll">
            <parameter stringID="5" />
            <parameter stringID="1002" resourceDll="IHV.dll" />
          </body>
          <buttons>
            <button stringID="1" resourceDll="IHV.dll" buttonID="IDOK"/>
            <button stringID="2" resourceDll="IHV.dll" buttonID="IDCANCEL"/>
          </buttons>
        </messageBoxUI>
      </requestOpen>
    </v1>
  </asyncPrintUIRequest>

Voir aussi

buttons