body 元素

  • 项目

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

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

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

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

使用情况

<body
  stringID = "xs:string"
  resourceDll = "xs:string">
  child elements
</body>

属性

属性 类型 必需 说明
resourceDll xs:string 否 一个可选属性，指定包含要显示在事件通知消息中的正文文本的资源 DLL。 此 DLL 应是打印机驱动程序的依赖文件，并且必须存在于驱动程序资源文件夹中， (例如%SYSTEMROOT%\system32\spool\drivers\w32x86\3) 。
stringID xs:string 是 一个必需属性，指定要在事件通知消息正文中显示的文本。 属性值指定文本字符串在资源 DLL 中的位置。

子元素

元素 说明
参数 一个可选元素，指定替换正文文本规范中的参数的文本字符串。

父元素

元素 说明
balloonUI 一个可选元素，用于在客户端计算机上显示消息气球。
messageBoxUI 一个可选元素，用于在客户端计算机上显示消息框。

注解

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

可以按顺序使用多个 正文 标记，在这种情况下，每个标记生成的文本将串联在事件通知消息中。 将在每对文本字符串之间插入一个空格。 同一通知消息可以同时显示：状态信息（例如“打印机墨迹不足”）和用户说明，例如“更换墨盒并按打印机上的恢复按钮继续”。

body 元素中包含的文本应让用户知道哪些操作可用。

使用以下建议使消息文本保持有用且简洁：

  • 使用带有结尾标点符号的完整句子。

  • 当本地化为其他语言时，撰写少于 255 个字符的正文文本。 例如，为了适应其他语言的本地化，英语邮件通常不应使用超过 200 个字符。

  • 包括允许用户完成请求的操作的基本信息，例如特定对象名称、用户名、文件名或 URL。 用户不必打开另一个窗口来查找此类信息。

  • 在对象名称周围放置双引号， (例如，“纸箱 1”) 。 但是，当对象名称使用大写单词（如用户名）时，不要使用引号，它与冒号 (偏移，例如打印机名称：我的打印机) ，或者可以从上下文中轻松确定它。

  • 如果必须将对象名称截断为固定的最大大小以适应本地化，请使用省略号 (...) 来指示截断。

  • 如果通知消息提供了用户操作按钮，请确保消息信息和按钮之间有两个换行符。 使用简单的面向操作的短语标记按钮，例如“单击以重新启动打印”或“单击以查看详细信息”。

  • 仅对用户可以自由忽略的非关键信息使用通知消息。 正文文本不应指出用户必须执行操作。

  • 如果用户应执行某个操作，请清楚地描述执行该操作的重要性和后果。

  • 使用简单语言描述问题，并提供有关用户如何解决问题的具体信息。

  • 以与用户相关的方式描述事件。 如果用户执行任务或更改通知行为的可能性合理，则通知消息是相关的。

  • 根据用户目标而不是技术问题描述事件。

示例

下面的代码示例演示如何使用 body 元素。

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

另请参阅

balloonUI

messageBoxUI

参数