élément customUI

Article
02/12/2024

L’élément customUI facultatif spécifie une interface utilisateur personnalisée à afficher sur un ordinateur client.

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

<customUI
  dll = "xs:string"
  entrypoint = "xs:string"
  bidi = "xs:string">
  child elements
</customUI>

Attributs

Attribut	Type	Obligatoire	Description
Bidi	xs:string	Yes	Attribut obligatoire qui spécifie le type de communication entre le pilote d’imprimante et le message de notification d’événement. Si la valeur est true, la communication est bidirectionnelle et la fonction de pilote dans la DLL de ressource doit retourner une chaîne ; consultez la section Exemple. Si la valeur est false, la communication est unidirectionnelle, du pilote d’imprimante au message de notification d’événement.
dll	xs:string	Yes	Attribut obligatoire qui spécifie une DLL de ressource qui contient la fonction d’affichage de l’interface utilisateur personnalisée. 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).
entrypoint	xs:string	Yes	Attribut obligatoire qui spécifie la fonction à appeler dans la DLL de ressource.

Éléments enfants

Élément	Description
Tout	Spécifie tout élément enfant en fonction du schéma d’interface utilisateur personnalisé. Consultez la section Exemple.

Éléments parents

Élément	Description
requestOpen	Élément utilisé pour ouvrir un message de notification d’événement sur l’ordinateur client.

Remarques

Étant donné que l’attribut bidi est défini sur true dans l’exemple suivant, la fonction de point d’entrée IHVFunction dans la DLL Abc.dll est appelée. IHVfunction retourne les données de type CDATA .

Exemples

L’exemple de code suivant montre comment utiliser l’élément customUI pour appeler et afficher une interface utilisateur personnalisée sur un ordinateur client.

<?xml version="1.0"?>
  <asyncPrintUIRequest xmlns="https://schemas.microsoft.com/2003/print/asyncui/1.0"
      xmlns:myco="https://www.myprintercompany.com">
    <requestOpen>
      <customUI dll="abc.dll" entrypoint="IHVFunction" bidi="true">
        <IHV:anyXMLData />
          CDATA
      </customUI>
    </requestOpen>
  </asyncPrintUIRequest>

Voir aussi

requestOpen

Partager via