parameter, элемент

Статья
07/18/2023

Необязательный элемент параметра задает текстовую строку, которая заменяется символом процента (%) в тексте сообщения уведомления о событии.

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

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

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

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

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

Атрибуты

attribute	Тип	Обязательно	Описание
resourceDll	xs:string	Нет	Необязательный атрибут, указывающий библиотеку DLL ресурса, содержащую текст, отображаемый в сообщении уведомления о событии. Эта библиотека DLL должна быть зависимым файлом драйвера принтера и присутствовать в папке ресурсов драйвера (например, %SYSTEMROOT%\system32\spool\drivers\w32x86\3).
stringID	xs:string	Да	Обязательный атрибут, указывающий текст, отображаемый в расположении символа процента (%) в тексте сообщения уведомления о событии. Значение атрибута указывает расположение текстовой строки в библиотеке DLL ресурса.
type	xs:string	Нет	Необязательный атрибут, указывающий имя принтера или документа. Этот атрибут может принимать одно из следующих значений:DocumentИмя печатаемого документа. PrinterNameИмя принтера, как указано в папке "Принтеры и факсы" в панель управления, например "Fabrikam 5000 on \printserver" или "Printer in upstairs bedroom".

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

Дочерние элементы отсутствуют.

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

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

Примеры

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

В этом примере значения stringID указывают следующее:

Строка пользовательского интерфейса 100 в библиотеке DLL ресурса драйвера имеет значение "Printer is out of %1 ink; Откройте %2 и замените чернила".
Строка пользовательского интерфейса 5 в библиотеке DLL пользовательского интерфейса, предоставляемой Корпорацией Майкрософт, имеет значение "yellow".
Строка пользовательского интерфейса 1002 в библиотеке DLL ресурса драйвера — "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

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