Elemento balloonUI

Artículo
02/07/2024

El elemento opcional balloonUI se usa para mostrar un globo de mensajes en el equipo cliente.

El elemento balloonUI 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

<balloonUI
  iconID = "xs:string"
  resourceDll = "xs:string">
  child elements
</balloonUI>

Atributos

Atributo	Tipo	Requerido	Descripción
iconID	xs:string	No	Atributo opcional que especifica un icono de impresora que se va a mostrar en el mensaje de notificación de eventos. El valor del atributo especifica la ubicación del icono en el archivo DLL de recursos. El icono debe tener un tamaño de 32 x 32 píxeles, con cualquier profundidad de color.
resourceDll	xs:string	No	Atributo opcional que especifica un archivo DLL de recursos que contiene el icono de impresora 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).

Elementos secundarios

Elemento	Descripción
body	Elemento necesario 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	Elemento necesario que proporciona texto que se muestra en el título del mensaje de notificación de eventos.

Elementos primarios

Elemento	Descripción
requestOpen	Elemento que se usa para abrir un mensaje de notificación de eventos en el equipo cliente.

Comentarios

Si no se especifican los atributos iconID y resourceDll , se muestra un icono de impresora genérico en el mensaje de globo. Para mostrar un icono de impresora personalizado, especifique valores para ambos atributos.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un globo interactivo para pasar datos de tipo CDATA a un archivo DLL.

<?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>
          <action dll="adc.dll" entrypoint="def" />
            IHV Data to pass into dll
            MUST BE CDATA
          </action>
        </balloonUI>
      </requestOpen>
    </v1>
  </asyncPrintUIRequest>