elemento de parámetro
El elemento de parámetro opcional especifica una cadena de texto que se sustituye por un carácter de porcentaje (%) en el texto de un mensaje de notificación de evento.
El elemento parameter se define en el espacio de nombres asyncui en este URI:
https://schemas.microsoft.com/2003/print/asyncui/v1/request
Es posible que este recurso no esté disponible en algunos idiomas y países.
Uso
<parameter
stringID = "xs:string"
resourceDll = "xs:string"
type = "xs:string"/>
Atributos
| Atributo | Tipo | Requerido | Descripción |
|---|---|---|---|
| resourceDll | xs:string | No | Atributo opcional que especifica un archivo DLL de recursos que contiene el texto que se va a mostrar en el mensaje de notificación de eventos. Este archivo DLL debe ser un archivo dependiente del controlador de impresora y debe estar presente en la carpeta de recursos del controlador (por ejemplo, %SYSTEMROOT%\system32\spool\drivers\w32x86\3). |
| stringID | xs:string | Sí | Atributo obligatorio que especifica el texto que se va a mostrar en la ubicación del carácter de porcentaje (%) en el texto del mensaje de notificación de evento. El valor del atributo especifica la ubicación de la cadena de texto en el archivo DLL de recursos. |
| type | xs:string | No | Atributo opcional que especifica el nombre de la impresora o el documento. Este atributo puede tomar uno de los siguientes valores:DocumentEl nombre del documento que se va a imprimir. PrinterNameEl nombre de la impresora, como se muestra en la carpeta Impresoras y faxes de Panel de control, por ejemplo, "Fabrikam 5000 en \printserver" o "Impresora en el dormitorio superior". |
Elementos secundarios
No hay elementos secundarios.
Elementos primarios
| Elemento | Descripción |
|---|---|
| body | Elemento obligatorio que proporciona texto que se muestra en el mensaje de notificación de eventos. Este texto debe proporcionar los detalles específicos del usuario sobre el evento de impresora. |
| Título | El elemento title requerido proporciona texto que se muestra en el título del mensaje de notificación de eventos. |
Comentarios
El texto cargado desde el archivo DLL de recursos puede contener caracteres de porcentaje (%) que se reemplazarán por cadenas de texto especificadas por el elemento de parámetro .
Ejemplos
En el ejemplo de código siguiente se muestra cómo se puede usar el elemento de parámetro para generar un mensaje de notificación de eventos completo.
En este ejemplo, los valores stringID especifican lo siguiente:
La cadena de interfaz de usuario 100 en el archivo DLL del recurso del controlador es "Printer is out of %1 ink; abra %2 y reemplace el cartucho de tinta".
La cadena de interfaz de usuario 5 del archivo DLL de la interfaz de usuario proporcionada por Microsoft es "amarillo".
La cadena de interfaz de usuario 1002 en el archivo DLL del recurso del controlador es "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>
Con el código XML anterior, se muestra el siguiente texto del cuerpo (stringID="100") en el mensaje de notificación de evento: "La impresora está fuera de tinta amarilla; abra la puerta de acceso lateral B y reemplace el cartucho de tinta".