Элемент body

Статья
06/15/2023

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

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

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

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

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

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

Атрибуты

attribute	Тип	Обязательно	Описание
resourceDll	xs:string	Нет	Необязательный атрибут, указывающий библиотеку DLL ресурса, содержащую основной текст, отображаемый в сообщении уведомления о событии. Эта библиотека DLL должна быть зависимым файлом драйвера принтера и присутствовать в папке ресурсов драйвера (например, %SYSTEMROOT%\system32\spool\drivers\w32x86\3).
stringID	xs:string	Да	Обязательный атрибут, указывающий текст, отображаемый в тексте сообщения уведомления о событии. Значение атрибута указывает расположение текстовой строки в библиотеке DLL ресурса.

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

Элемент	Описание
Параметр	Необязательный элемент, указывающий текстовые строки, заменяющие параметры в спецификации основного текста.

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

Элемент	Описание
balloonUI	Необязательный элемент, используемый для отображения всплывающего сообщения на клиентском компьютере.
messageBoxUI	Необязательный элемент, используемый для отображения окна сообщения на клиентском компьютере.

Основной текст, загруженный из библиотеки DLL ресурса, может содержать теги процента (%), которые будут заменены текстовыми строками, заданными дочерним элементом параметра .

Несколько тегов текста можно использовать последовательно, и в этом случае текст, созданный каждым из них, будет сцеплен в сообщении уведомления о событии. Между каждой парой текстовых строк будет вставлен пробел. В одном и том же уведомлении могут отображаться как сведения о состоянии, например "Ваш принтер не имеет рукописного ввода", так и инструкции для пользователя, например "Замените рукописный патрон и нажмите кнопку Возобновить на принтере, чтобы продолжить".

Текст, содержащийся в элементе body , должен сообщить пользователю, какое действие доступно.

Используйте следующие рекомендации, чтобы текст сообщения был полезным и кратким.

Используйте полные предложения с конечными знаками препинания.
Создание основного текста, который может содержать менее 255 символов при локализации на других языках. Например, сообщение на английском языке обычно не должно содержать более 200 символов, чтобы обеспечить локализацию на других языках.
Включите важные сведения, позволяющие пользователю выполнить запрошенное действие, например имена конкретных объектов, имена пользователей, имена файлов или URL-адреса. Пользователям не нужно открывать другое окно для поиска таких сведений.
Поместите двойные кавычки вокруг имен объектов (например, "Paper Bin 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

Параметр

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