customUI-Element

Artikel
02/12/2024

Das optionale customUI-Element gibt eine benutzerdefinierte Benutzeroberfläche an, die auf einem Clientcomputer angezeigt werden soll.

Das customUI-Element wird im asyncui-Namespace unter diesem URI definiert:

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

Diese Ressource ist in einigen Sprachen und Ländern möglicherweise nicht verfügbar.

Verbrauch

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

Attribute

attribute	Typ	Erforderlich	BESCHREIBUNG
Bidi	xs:string	Yes	Ein erforderliches Attribut, das den Typ der Kommunikation zwischen dem Druckertreiber und der Ereignisbenachrichtigung angibt. Wenn der Wert true ist, erfolgt die Kommunikation bidirektional, und die Treiberfunktion in der Ressourcen-DLL muss eine Zeichenfolge zurückgeben. Weitere Informationen finden Sie im Abschnitt Beispiel. Wenn der Wert false ist, erfolgt die Kommunikation unidirektional, vom Druckertreiber zur Ereignisbenachrichtigung.
Dll	xs:string	Yes	Ein erforderliches Attribut, das eine Ressourcen-DLL angibt, die die benutzerdefinierte Anzeigefunktion der Benutzeroberfläche enthält. Diese DLL sollte eine abhängige Datei des Druckertreibers sein und im Treiberressourcenordner vorhanden sein (z. B. %SYSTEMROOT%\system32\spool\drivers\w32x86\3).
entrypoint	xs:string	Yes	Ein erforderliches Attribut, das die Funktion angibt, die in der Ressourcen-DLL aufgerufen werden soll.

Untergeordnete Elemente

Element	BESCHREIBUNG
Irgendetwas	Gibt ein beliebiges untergeordnetes Element gemäß dem benutzerdefinierten Benutzeroberflächenschema an. Weitere Informationen finden Sie im Beispielabschnitt.

Übergeordnete Elemente

Element	BESCHREIBUNG
requestÖffnen	Ein Element, das zum Öffnen einer Ereignisbenachrichtigung auf dem Clientcomputer verwendet wird.

Hinweise

Da das bidi-Attribut im folgenden Beispiel auf true festgelegt ist, wird die IHVFunction-Einstiegspunktfunktion in der Abc.dll DLL aufgerufen. IHVfunction gibt die Daten des CDATA-Typs zurück.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie das customUI-Element verwenden, um eine benutzerdefinierte Benutzeroberfläche auf einem Clientcomputer aufzurufen und anzuzeigen.

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

Weitere Informationen

requestÖffnen

Freigeben über