elemento body
El elemento body requerido 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.
El elemento body 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
<body
stringID = "xs:string"
resourceDll = "xs:string">
child elements
</body>
Atributos
| Atributo | Tipo | Requerido | Descripción |
|---|---|---|---|
| resourceDll | xs:string | No | Atributo opcional que especifica un archivo DLL de recursos que contiene el texto del cuerpo 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 el cuerpo del mensaje de notificación de eventos. El valor del atributo especifica la ubicación de la cadena de texto en el archivo DLL de recursos. |
Elementos secundarios
| Elemento | Descripción |
|---|---|
| Parámetro | Elemento opcional que especifica cadenas de texto que sustituyen los parámetros de una especificación de texto del cuerpo. |
Elementos primarios
| Elemento | Descripción |
|---|---|
| balloonUI | Elemento opcional que se usa para mostrar un globo de mensajes en el equipo cliente. |
| messageBoxUI | Elemento opcional que se usa para mostrar un cuadro de mensaje en el equipo cliente. |
Comentarios
El texto del cuerpo cargado desde el archivo DLL de recursos puede contener etiquetas de porcentaje (%) que se reemplazarán por cadenas de texto especificadas por el elemento secundario del parámetro .
Se pueden usar varias etiquetas de cuerpo secuencialmente, en cuyo caso el texto generado por cada uno se concatenará en el mensaje de notificación de evento. Se insertará un espacio entre cada par de cadenas de texto. El mismo mensaje de notificación puede mostrar tanto: información de estado, como "La impresora está fuera de tinta", e instrucciones para el usuario, como "Reemplazar el cartucho de tinta y presionar el botón Reanudar de la impresora para continuar".
El texto contenido en el elemento body debe indicar al usuario qué acción está disponible.
Use las siguientes recomendaciones para mantener útil y conciso el texto del mensaje:
Use oraciones completas con puntuación final.
Redactar texto del cuerpo que puede tener menos de 255 caracteres cuando se localiza en otros idiomas. Por ejemplo, un mensaje en inglés normalmente no debe usar más de 200 caracteres para dar cabida a la localización en otros idiomas.
Incluya información esencial que permita al usuario completar una acción solicitada, como nombres de objeto específicos, nombres de usuario, nombres de archivo o direcciones URL. Los usuarios no deben tener que abrir otra ventana para encontrar dicha información.
Coloque comillas dobles alrededor de los nombres de objeto (por ejemplo, "Papel papelera 1"). Sin embargo, no use comillas cuando el nombre del objeto use palabras en mayúsculas, como un nombre de usuario, se desplaza con dos puntos (por ejemplo, Nombre de impresora: Mi impresora) o se puede determinar fácilmente desde el contexto.
Si tiene que truncar los nombres de objeto a un tamaño máximo fijo para dar cabida a la localización, use un botón de puntos suspensivos (...) para indicar el truncamiento.
Si un mensaje de notificación proporciona un botón para la acción del usuario, asegúrese de que hay dos saltos de línea entre la información del mensaje y el botón. Etiquete el botón con frases sencillas orientadas a acciones, como "Haga clic para reiniciar la impresión" o "Haga clic para ver más información".
Use únicamente mensajes de notificación para información no crítica que el usuario pueda omitir libremente. El texto del cuerpo no debe decir que el usuario debe realizar una acción.
Si el usuario debe realizar una acción, describa claramente la importancia y las consecuencias de realizar la acción.
Describir problemas en lenguaje sin formato con información específica sobre cómo el usuario puede corregir el problema.
Describa el evento de forma que sea relevante para el usuario. Un mensaje de notificación es relevante si hay una posibilidad razonable de que un usuario realice una tarea o un comportamiento de cambio como resultado de la notificación.
Describir un evento en términos de objetivos de usuario, en lugar de en términos de problemas tecnológicos.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar el elemento 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>