elemento parameter
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."