Freigeben über

parameter-Element

  • Artikel

Das optionale Parameterelement gibt eine Textzeichenfolge an, die durch ein Prozentzeichen (%) im Text einer Ereignisbenachrichtigung ersetzt wird.

Das Parameterelement wird im asyncui-Namespace an 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

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

Attribute

attribute Typ Erforderlich BESCHREIBUNG
resourceDll xs:string No Ein optionales Attribut, das eine Ressourcen-DLL angibt, die den Text enthält, der in der Ereignisbenachrichtigung angezeigt werden soll. Diese DLL sollte eine abhängige Datei des Druckertreibers sein und muss im Treiberressourcenordner vorhanden sein (z. B. %SYSTEMROOT%\system32\spool\drivers\w32x86\3).
stringID xs:string Yes Ein erforderliches Attribut, das den Text angibt, der an der Position des Prozentzeichens (%) im Text der Ereignisbenachrichtigung angezeigt werden soll. Der Attributwert gibt den Speicherort der Textzeichenfolge in der Ressourcen-DLL an.
type xs:string No Ein optionales Attribut, das den Namen des Druckers oder Dokuments angibt. Dieses Attribut kann einen der folgenden Werte annehmen:DocumentDer Name des gedruckten Dokuments. PrinterNameDer Name des Druckers, wie im Ordner Drucker und Faxe in Systemsteuerung aufgeführt, z. B. "Fabrikam 5000 auf \printserver" oder "Drucker im Schlafzimmer im Obergeschoss".

Untergeordnete Elemente

Es gibt keine untergeordneten Elemente.

Übergeordnete Elemente

Element BESCHREIBUNG
body Ein erforderliches Element, das Text bereitstellt, der in der Ereignisbenachrichtigung angezeigt wird. Dieser Text sollte die benutzerspezifischen Details zum Druckerereignis enthalten.
Titel Das erforderliche title-Element stellt Text bereit, der im Titel der Ereignisbenachrichtigungsnachricht angezeigt wird.

Hinweise

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

Beispiele

Das folgende Codebeispiel zeigt, wie das Parameterelement verwendet werden kann, um eine vollständige Ereignisbenachrichtigung zu generieren.

In diesem Beispiel geben die stringID-Werte Folgendes an:

  • Benutzeroberfläche Zeichenfolge 100 in der Treiberressourcen-DLL lautet "Printer is out of %1 ink; öffnen Sie %2, und ersetzen Sie die Tintenpatrone."

  • Die Benutzeroberfläche Zeichenfolge 5 in der von Microsoft bereitgestellten Benutzeroberfläche-DLL ist "gelb".

  • Die Benutzeroberfläche Zeichenfolge 1002 in der Treiberressourcen-DLL lautet "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>

Mit dem vorherigen XML-Code wird der folgende Textkörper (stringID="100") in der Ereignisbenachrichtigungsmeldung angezeigt: "Printer is out of yellow tint; Öffnen Sie die Tür für den Seitenzugang B, und ersetzen Sie die Tintenpatrone."

Weitere Informationen

body

title