通过

参数元素

  • 项目

可选的 参数 元素指定一个文本字符串，该字符串将替换为事件通知消息文本中的百分比 (%) 字符。

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

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

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

使用情况

<parameter
  stringID = "xs:string"
  resourceDll = "xs:string"
  type = "xs:string"/>

属性

属性 类型 必需 说明
resourceDll xs:string 否 一个可选属性，用于指定包含要显示在事件通知消息中的文本的资源 DLL。 此 DLL 应是打印机驱动程序的依赖文件，并且必须存在于驱动程序资源文件夹中， (例如%SYSTEMROOT%\system32\spool\drivers\w32x86\3) 。
stringID xs:string 是 一个必需属性，指定要在事件通知消息文本中百分比 (%) 字符的位置显示的文本。 属性值指定文本字符串在资源 DLL 中的位置。
type xs:string 否 一个可选属性，指定打印机或文档的名称。 此属性可以采用以下值之一：Document正在打印的文档的名称。PrinterName打印机的名称，如控制面板的“打印机和传真”文件夹中列出，例如“打印服务器上的 Fabrikam 5000”或“楼上卧室中的打印机”。

子元素

没有子元素。

父元素

元素 说明
body 提供事件通知消息中显示的文本的必需元素。 此文本应提供有关打印机事件的用户特定详细信息。
标题 所需的 title 元素提供显示在事件通知消息标题中的文本。

注解

从资源 DLL 加载的文本可以包含百分比 (%) 字符，这些字符将替换为 参数 元素指定的文本字符串。

示例

下面的代码示例演示如何使用 参数 元素来生成完整的事件通知消息。

在此示例中， stringID 值指定以下内容：

  • 驱动程序资源 DLL 中的用户界面字符串 100 为“打印机的墨迹不足 %1;请打开 %2 并更换墨盒。”

  • Microsoft 提供的用户界面 DLL 中的用户界面字符串 5 为“黄色”。

  • 驱动程序资源 DLL 中的用户界面字符串 1002 为“Side Access Door B”。

<?xml version="1.0" ?>
   <asyncPrintUIRequest
    xmlns="https://schemas.microsoft.com/2003/print/asyncui/v1/request">
    <v1>
      <requestOpen>
        <balloonUI iconID="1" resourceDll="IHV.dll">
          <title stringID="1234" resourceDll="IHV.dll" />
          <body stringID="100" resourceDll="IHV.dll">
            <parameter stringID="5" />
            <parameter stringID="1002" resourceDll="IHV.dll" />
          </body>
        </balloonUI>
      </requestOpen>
    </v1>
  </asyncPrintUIRequest>

使用前面的 XML 代码，以下正文文本 (stringID=“100”) 显示在事件通知消息中：“打印机没有黄色墨迹;请打开侧门 B 并更换墨盒。”

另请参阅

body

title