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>