Compartilhar via

elemento action

  • Artigo

O elemento de ação opcional descreve uma ação que será concluída quando um usuário clicar em um botão na mensagem de balão.

O elemento action é 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

<action
  dll = "xs:string"
  entrypoint = "xs:string">
  text
</action>

Atributos

Atributo Tipo Obrigatório Descrição
Dll xs:string Yes Um atributo obrigatório que especifica uma DLL, fornecida por um IHV, que contém uma função a ser chamada quando um usuário clica em um botão.
entrypoint xs:string Yes Um atributo obrigatório que especifica a função a ser chamada na DLL fornecida pelo IHV. Essa função deve retornar NULL quando chamada.

Valor de texto

Cadeia de caracteres opcional, formatada como CDATA, a ser passada para a DLL do recurso de driver.

Elementos filho

Não há elementos filho.

Elementos pai

Elemento Descrição
balloonUI Fornece o texto exibido na mensagem de notificação de evento. Esse texto deve fornecer ao usuário detalhes específicos sobre o evento da impressora.

Comentários

O elemento de ação é usado com um balão interativo, que é semelhante a um balão regular, mas inclui um botão para o usuário clicar.

Exemplos

O exemplo de código XML a seguir executará o programa IHV.exe no computador cliente.

<?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>

O exemplo de código a seguir mostra como usar o elemento de ação para passar dados para uma DLL de recurso.

<?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 CDATA to pass into the resource DLL
          </action>
        </balloonUI>
      </requestOpen>
    </v1>
  </asyncPrintUIRequest>

Confira também

balloonUI