Partilhar via

elemento button

  • Artigo

O elemento de botão necessário especifica as características de um botão em uma caixa de mensagem exibida no computador cliente.

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

<button
  stringID = "xs:string"
  resourceDll = "xs:string"
  buttonID = "xs:string"/>

Atributos

Atributo Tipo Obrigatório Descrição
buttonID xs:string Yes Um atributo obrigatório que especifica a cadeia de caracteres que será retornada ao driver da impressora quando o usuário clicar no botão. Esse atributo pode ter um dos seguintes valores:

IDOK - Um botão com o nome "OK" será exibido na caixa de mensagem. Quando o usuário clica no botão, a caixa de mensagem retorna a cadeia de caracteres "IDOK".

IDCANCEL - Um botão com o nome "CANCEL" será exibido na caixa de mensagem. Quando o usuário clica no botão, a caixa de mensagem retorna a cadeia de caracteres "IDCANCEL".
resourceDll xs:string No Um atributo opcional que especifica uma DLL de recurso que contém o texto a ser exibido no botão. 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).
stringID xs:string Yes Um atributo necessário que especifica o texto a ser exibido no botão. O valor do atributo especifica o local da cadeia de caracteres de texto na DLL do recurso.

Elementos filho

Não há elementos filho.

Elementos pai

Elemento Descrição
buttons Um elemento necessário que especifica um ou mais botões exibidos na caixa de mensagem de notificação de eventos no computador cliente.

Comentários

Os botões serão exibidos na parte inferior da caixa de mensagem.

Exemplos

O exemplo de código a seguir mostra como usar o elemento de botão para exibir botões OK e CANCEL um ao lado do outro.

<?xml version="1.0" ?>
  <asyncPrintUIRequest
    xmlns="https://schemas.microsoft.com/2003/print/asyncui/v1/request">
    <v1>
      <requestOpen>
        <messageBoxUI>
          <title stringID="1234" resourceDll="IHV.dll" />
          <body stringID="100" resourceDll="IHV.dll">
            <parameter stringID="5" />
            <parameter stringID="1002" resourceDll="IHV.dll" />
          </body>
          <buttons>
            <button stringID="1" resourceDll="IHV.dll" buttonID="IDOK"/>
            <button stringID="2" resourceDll="IHV.dll" buttonID="IDCANCEL"/>
          </buttons>
        </messageBoxUI>
      </requestOpen>
    </v1>
  </asyncPrintUIRequest>

Confira também

buttons