Elemento customUI

El elemento customUI opcional especifica una interfaz de usuario personalizada que se mostrará en un equipo cliente.

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

<customUI
  dll = "xs:string"
  entrypoint = "xs:string"
  bidi = "xs:string">
  child elements
</customUI>

Atributos

Atributo	Tipo	Requerido	Descripción
Bidi	xs:string	Sí	Atributo necesario que especifica el tipo de comunicación entre el controlador de impresora y el mensaje de notificación de eventos. Si el valor es true, la comunicación es bidireccional y la función del controlador en el archivo DLL de recursos debe devolver una cadena; consulte la sección Ejemplo. Si el valor es false, la comunicación es unidireccional, desde el controlador de impresora hasta el mensaje de notificación de eventos.
Dll	xs:string	Sí	Atributo necesario que especifica un archivo DLL de recursos que contiene la función de visualización de la interfaz de usuario personalizada. 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).
entrypoint	xs:string	Sí	Atributo necesario que especifica la función a la que se va a llamar en el archivo DLL de recursos.

Elementos secundarios

Elemento	Descripción
Cualquiera	Especifica cualquier elemento secundario según el esquema de la interfaz de usuario personalizada. Vea la sección de ejemplo.

Elementos primarios

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

Comentarios

Dado que el atributo bidi se establece en true en el ejemplo siguiente, se llamará a la función de punto de entrada IHVFunction en el archivo DLL deAbc.dll . IHVfunction devuelve los datos de tipo CDATA .

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el elemento customUI para llamar a y mostrar una interfaz de usuario personalizada en un equipo cliente.

<?xml version="1.0"?>
  <asyncPrintUIRequest xmlns="https://schemas.microsoft.com/2003/print/asyncui/1.0"
      xmlns:myco="https://www.myprintercompany.com">
    <requestOpen>
      <customUI dll="abc.dll" entrypoint="IHVFunction" bidi="true">
        <IHV:anyXMLData />
          CDATA
      </customUI>
    </requestOpen>
  </asyncPrintUIRequest>

Consulte también

requestOpen