Elemento customUI

O elemento customUI opcional especifica uma interface do usuário personalizada a ser exibida em um computador cliente.

O elemento customUI é definido no namespace asyncui neste URI:

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

Esse recurso pode não estar disponível em alguns idiomas e países.

Uso

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

Atributos

Atributo	Tipo	Obrigatório	Descrição
Bidi	xs:string	Yes	Um atributo necessário que especifica o tipo de comunicação entre o driver da impressora e a mensagem de notificação de evento. Se o valor for true, a comunicação será bidirecional e a função de driver na DLL do recurso deverá retornar uma cadeia de caracteres; consulte a seção Exemplo. Se o valor for false, a comunicação será unidirecional, desde o driver da impressora até a mensagem de notificação de evento.
Dll	xs:string	Yes	Um atributo necessário que especifica uma DLL de recurso que contém a função de exibição da interface do usuário personalizada. Essa DLL deve ser um arquivo dependente do driver de impressora e deve estar presente na pasta de recursos do driver (por exemplo, %SYSTEMROOT%\system32\spool\drivers\w32x86\3).
entrypoint	xs:string	Yes	Um atributo necessário que especifica a função a ser chamada na DLL do recurso.

Elementos filho

Elemento	Descrição
Nada	Especifica qualquer elemento filho de acordo com o esquema de interface do usuário personalizado. Consulte a seção Exemplo.

Elementos pai

Elemento	Descrição
requestOpen	Um elemento usado para abrir uma mensagem de notificação de evento no computador cliente.

Comentários

Como o atributo bidi é definido como true no exemplo a seguir, a função de ponto de entrada IHVFunction no Abc.dll DLL será chamada. IHVfunction retorna os dados de tipo CDATA .

Exemplos

O exemplo de código a seguir mostra como usar o elemento customUI para chamar e exibir uma interface do usuário personalizada em um computador 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>

Confira também

requestOpen