Элемент customUI

2024-02-07

Необязательный элемент customUI указывает пользовательский интерфейс для отображения на клиентском компьютере.

Элемент customUI определяется в пространстве имен asyncui по этому универсальному коду ресурса (URI):

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

Этот ресурс может быть недоступен на некоторых языках и в некоторых странах.

Использование

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

Атрибуты

attribute	Тип	Обязательно	Описание
Bidi	xs:string	Да	Обязательный атрибут, указывающий тип взаимодействия между драйвером принтера и сообщением уведомления о событии. Если значение равно true, обмен данными является двунаправленным, а функция драйвера в библиотеке DLL ресурса должна возвращать строку; См. раздел Пример. Если значение равно false, обмен данными осуществляется односторонняя, от драйвера принтера до сообщения уведомления о событии.
Dll	xs:string	Да	Обязательный атрибут, указывающий библиотеку DLL ресурса, содержащую функцию отображения пользовательского интерфейса. Эта библиотека DLL должна быть зависимым файлом драйвера принтера и присутствовать в папке ресурсов драйвера (например, %SYSTEMROOT%\system32\spool\drivers\w32x86\3).
entrypoint;	xs:string	Да	Обязательный атрибут, указывающий функцию, вызываемую в библиотеке DLL ресурса.

Дочерние элементы

Элемент	Описание
Ничего	Задает любой дочерний элемент в соответствии с пользовательской схемой пользовательского интерфейса. См. раздел «Пример».

Родительские элементы

Элемент	Описание
requestОткрыть	Элемент, используемый для открытия сообщения уведомления о событии на клиентском компьютере.

Так как в следующем примере атрибуту bidi присвоено значение true , будет вызвана функция точки входа IHVFunction в библиотеке DLLAbc.dll . Функция IHVfunction возвращает данные типа CDATA .

Примеры

В следующем примере кода показано, как использовать элемент customUI для вызова и отображения пользовательского интерфейса на клиентском компьютере.

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

См. также раздел

requestОткрыть

Поделиться через