Compartilhar via

elemento parameter

  • Artigo

O elemento de parâmetro opcional especifica uma cadeia de caracteres de texto que é substituída por um caractere percentual (%) no texto de uma mensagem de notificação de evento.

O elemento de parâmetro é 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

<parameter
  stringID = "xs:string"
  resourceDll = "xs:string"
  type = "xs:string"/>

Atributos

Atributo Tipo Obrigatório Descrição
resourceDll xs:string No Um atributo opcional que especifica uma DLL de recurso que contém o texto a ser exibido na mensagem de notificação de evento. 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 obrigatório que especifica o texto a ser exibido no local do caractere percentual (%) no texto da mensagem de notificação de evento. O valor do atributo especifica o local da cadeia de caracteres de texto na DLL do recurso.
tipo xs:string No Um atributo opcional que especifica o nome da impressora ou do documento. Esse atributo pode usar um dos seguintes valores: DocumentO nome do documento que está sendo impresso. PrinterNameO nome da impressora, conforme listado na pasta Impressoras e Faxes no Painel de Controle, por exemplo, "Fabrikam 5000 em \printserver" ou "Impressora no quarto de cima".

Elementos filho

Não há elementos filho.

Elementos pai

Elemento Descrição
body Um elemento obrigatório que 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.
Título O elemento de título necessário fornece o texto exibido no título da mensagem de notificação de evento.

Comentários

O texto carregado da DLL do recurso pode conter caracteres percentuais (%) que serão substituídos por cadeias de caracteres de texto especificadas pelo elemento de parâmetro .

Exemplos

O exemplo de código a seguir mostra como o elemento de parâmetro pode ser usado para gerar uma mensagem de notificação de evento completa.

Neste exemplo, os valores de stringID especificam o seguinte:

  • A cadeia de caracteres de interface do usuário 100 na DLL do recurso de driver é "A impressora está sem %1 tinta; abra %2 e substitua o cartucho de tinta."

  • A cadeia de caracteres de interface do usuário 5 na DLL da interface do usuário fornecida pela Microsoft é "amarela".

  • A cadeia de caracteres de interface do usuário 1002 na DLL do recurso de driver é "Side Access Door B".

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

Com o código XML anterior, o seguinte texto do corpo (stringID="100") é exibido na mensagem de notificação de evento: "A impressora está sem tinta amarela; abra a Porta B do Side Access e substitua o cartucho de tinta."

Confira também

body

title