Compartilhar via

elemento body

  • Artigo

O elemento body necessário fornece texto exibido na mensagem de notificação do evento. Esse texto deve fornecer ao usuário detalhes específicos sobre o evento da impressora.

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

<body
  stringID = "xs:string"
  resourceDll = "xs:string">
  child elements
</body>

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 do corpo a ser exibido na mensagem de notificação do 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 corpo da mensagem de notificação do evento. O valor do atributo especifica o local da cadeia de caracteres de texto na DLL do recurso.

Elementos filho

Elemento Descrição
Parâmetro Um elemento opcional que especifica cadeias de caracteres de texto que substituem parâmetros em uma especificação de texto do corpo.

Elementos pai

Elemento Descrição
balloonUI Um elemento opcional que é usado para exibir um balão de mensagem no computador cliente.
messageBoxUI Um elemento opcional usado para exibir uma caixa de mensagem no computador cliente.

Comentários

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

Várias marcas de corpo podem ser usadas sequencialmente, nesse caso, o texto gerado por cada um será concatenado na mensagem de notificação de evento. Um espaço será inserido entre cada par de cadeias de caracteres de texto. A mesma mensagem de notificação pode exibir ambas: status informações, como "Sua impressora está sem tinta". E instruções para o usuário, como "Substitua o cartucho de tinta e pressione o botão Retomar na impressora para continuar".

O texto contido no elemento body deve informar ao usuário qual ação está disponível.

Use as seguintes recomendações para manter o texto da mensagem útil e conciso:

  • Use frases completas com pontuação final.

  • Redigir texto do corpo que pode ter menos de 255 caracteres quando localizado em outros idiomas. Por exemplo, uma mensagem em inglês normalmente não deve usar mais de 200 caracteres para acomodar a localização em outros idiomas.

  • Inclua informações essenciais que permitem ao usuário concluir uma ação solicitada, como nomes de objeto específicos, nomes de usuário, nomes de arquivo ou URLs. Os usuários não devem precisar abrir outra janela para encontrar essas informações.

  • Coloque aspas duplas em torno de nomes de objeto (por exemplo, "Compartimento de Papel 1"). No entanto, não use aspas quando o nome do objeto usa palavras maiúsculas, como um nome de usuário, é deslocado com dois-pontos (por exemplo, Nome da impressora: Minha impressora) ou pode ser facilmente determinado a partir do contexto.

  • Se você precisar truncar nomes de objetos para um tamanho máximo fixo para acomodar a localização, use uma reticências (...) para indicar truncamento.

  • Se uma mensagem de notificação fornecer um botão para a ação do usuário, verifique se há duas quebras de linha entre as informações da mensagem e o botão. Rotule o botão com frases simples orientadas a ações, como "Clique para reiniciar a impressão" ou "Clique para ver mais informações".

  • Use apenas mensagens de notificação para informações não críticas que o usuário pode ignorar livremente. O texto do corpo não deve dizer que o usuário deve executar uma ação.

  • Se o usuário deve executar uma ação, descreva claramente a importância e as consequências da execução da ação.

  • Descrever problemas em linguagem simples com informações específicas sobre como o usuário pode corrigir o problema.

  • Descreva o evento de uma forma relevante para o usuário. Uma mensagem de notificação será relevante se houver uma chance razoável de um usuário executar uma tarefa ou alterar o comportamento como resultado da notificação.

  • Descrever um evento em termos de metas do usuário, em vez de em termos de problemas tecnológicos.

Exemplos

O exemplo de código a seguir mostra como usar o elemento body .

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

Confira também

balloonUI

messageBoxUI

parameter