body-Element

Artikel
06/15/2023

Das erforderliche Body-Element stellt Text bereit, der in der Ereignisbenachrichtigung angezeigt wird. Dieser Text sollte die benutzerspezifischen Details zum Druckerereignis enthalten.

Das body-Element wird im asyncui-Namespace unter diesem URI definiert:

https://schemas.microsoft.com/2003/print/asyncui/v1/request

Diese Ressource ist in einigen Sprachen und Ländern möglicherweise nicht verfügbar.

Verbrauch

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

Attribute

attribute	Typ	Erforderlich	BESCHREIBUNG
resourceDll	xs:string	No	Ein optionales Attribut, das eine Ressourcen-DLL angibt, die den Textkörper enthält, der in der Ereignisbenachrichtigung angezeigt werden soll. Diese DLL sollte eine abhängige Datei des Druckertreibers sein und im Treiberressourcenordner vorhanden sein (z. B. %SYSTEMROOT%\system32\spool\drivers\w32x86\3).
stringID	xs:string	Yes	Ein erforderliches Attribut, das den Text angibt, der im Text der Ereignisbenachrichtigung angezeigt werden soll. Der Attributwert gibt den Speicherort der Textzeichenfolge in der Ressourcen-DLL an.

Untergeordnete Elemente

Element	BESCHREIBUNG
Parameter	Ein optionales Element, das Textzeichenfolgen angibt, die Parameter in einer Textkörperspezifikation ersetzen.

Übergeordnete Elemente

Element	BESCHREIBUNG
balloonUI	Ein optionales Element, das zum Anzeigen einer Meldungssprechblase auf dem Clientcomputer verwendet wird.
messageBoxUI	Ein optionales Element, das zum Anzeigen eines Meldungsfelds auf dem Clientcomputer verwendet wird.

Hinweise

Der aus der Ressourcen-DLL geladene Text kann Prozenttags (%) enthalten, die durch Textzeichenfolgen ersetzt werden, die vom untergeordneten Parameterelement angegeben werden.

Mehrere Texttags können sequenziell verwendet werden. In diesem Fall wird der von jedem generierte Text in der Ereignisbenachrichtigung verkettet. Zwischen jedem Textzeichenfolgenpaar wird ein Leerzeichen eingefügt. Die gleiche Benachrichtigung kann beides anzeigen: status Informationen, z. B. "Ihr Drucker ist nicht mehr frei." und Anweisungen für den Benutzer, z. B. "Ersetzen Sie die Tintenpatrone, und drücken Sie die Schaltfläche Fortsetzen auf dem Drucker, um fortzufahren."

Der im Body-Element enthaltene Text sollte dem Benutzer mitteilen, welche Aktion verfügbar ist.

Verwenden Sie die folgenden Empfehlungen, um den Nachrichtentext nützlich und präzise zu halten:

Verwenden Sie vollständige Sätze mit endender Interpunktion.
Erstellen Sie Textkörper, der weniger als 255 Zeichen lang sein kann, wenn er in andere Sprachen lokalisiert wird. Beispielsweise sollte eine Nachricht in Englisch in der Regel nicht mehr als 200 Zeichen verwenden, um die Lokalisierung in andere Sprachen zu ermöglichen.
Schließen Sie wichtige Informationen ein, die es dem Benutzer ermöglichen, eine angeforderte Aktion auszuführen, z. B. bestimmte Objektnamen, Benutzernamen, Dateinamen oder URLs. Benutzer sollten kein anderes Fenster öffnen müssen, um solche Informationen zu finden.
Platzieren Sie doppelte Anführungszeichen um Objektnamen (z. B. "Papierkorb 1"). Verwenden Sie jedoch keine Anführungszeichen, wenn der Objektname groß geschriebene Wörter wie einen Benutzernamen verwendet, er durch einen Doppelpunkt versetzt wird (z. B. Druckername: Mein Drucker), oder er kann einfach aus dem Kontext bestimmt werden.
Wenn Sie Objektnamen auf eine feste maximale Größe abschneiden müssen, um die Lokalisierung zu ermöglichen, verwenden Sie eine Auslassungspunkte (...), um die Abschneidung anzugeben.
Wenn eine Benachrichtigung eine Schaltfläche für die Benutzeraktion bereitstellt, stellen Sie sicher, dass zwischen den Nachrichteninformationen und der Schaltfläche zwei Zeilenumbrüche vorhanden sind. Beschriften Sie die Schaltfläche mit einfachen aktionsorientierten Ausdrücken, z. B. "Klicken Sie, um den Druck neu zu starten" oder "Klicken Sie, um weitere Informationen anzuzeigen".
Verwenden Sie Benachrichtigungen nur für nicht kritische Informationen, die der Benutzer frei ignorieren kann. Im Textkörper darf nicht angegeben werden, dass der Benutzer eine Aktion ausführen muss.
Wenn der Benutzer eine Aktion ausführen soll, beschreiben Sie die Bedeutung und die Konsequenzen der Ausführung der Aktion klar.
Beschreiben Sie Probleme in einfacher Sprache mit spezifischen Informationen darüber, wie der Benutzer das Problem beheben kann.
Beschreiben Sie das Ereignis auf eine Weise, die für den Benutzer relevant ist. Eine Benachrichtigung ist relevant, wenn die Wahrscheinlichkeit besteht, dass ein Benutzer aufgrund der Benachrichtigung eine Aufgabe ausführt oder das Verhalten ändert.
Beschreiben Sie ein Ereignis in Bezug auf Benutzerziele und nicht in Bezug auf technologische Probleme.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des body-Elements veranschaulicht.

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

Weitere Informationen

balloonUI

messageBoxUI

Parameter

Freigeben über