customUI 元素

可选的 customUI 元素指定要在客户端计算机上显示的自定义用户界面。

customUI 元素在此 URI 的 asyncui 命名空间中定义：

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

此资源可能在某些语言和国家/地区不可用。

使用情况

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

属性

属性	类型	必需	说明
bidi	xs:string	是	指定打印机驱动程序与事件通知消息之间的通信类型的必需属性。 如果值为 true，则通信是双向的，并且资源 DLL 中的驱动程序函数必须返回字符串;请参阅示例部分。 如果值为 false，则通信是单向的，从打印机驱动程序到事件通知消息。
Dll	xs:string	是	一个必需的属性，指定包含自定义用户界面显示函数的资源 DLL。 此 DLL 应是打印机驱动程序的依赖文件，并且必须存在于驱动程序资源文件夹 (例如%SYSTEMROOT%\system32\spool\drivers\w32x86\3) 。
entrypoint	xs:string	是	一个必需的属性，指定要在资源 DLL 中调用的函数。

子元素

元素	说明
任意	根据自定义用户界面架构指定任何子元素。 请参见“示例”一节。

父元素

元素	说明
requestOpen	一个元素，用于在客户端计算机上打开事件通知消息。

注解

由于以下示例中的 bidi 属性设置为 true，因此将调用 Abc.dll DLL 中的 IHVFunction 入口点函数。 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>

另请参阅

requestOpen