Condividi tramite


parameter, elemento

L'elemento parametro facoltativo specifica una stringa di testo sostituita da un carattere percentuale (%) nel testo di un messaggio di notifica degli eventi.

L'elemento del parametro è definito nello spazio dei nomi asyncui in questo URI:

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

Questa risorsa potrebbe non essere disponibile in alcune lingue e paesi.

Utilizzo

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

Attributi

Attributo Type Obbligatoria Descrizione
resourceDll xs:string No Attributo facoltativo che specifica una DLL di risorse contenente il testo da visualizzare nel messaggio di notifica degli eventi. Questa DLL deve essere un file dipendente del driver della stampante e deve essere presente nella cartella delle risorse del driver, ad esempio %SYSTEMROOT%\system32\spool\drivers\w32x86\3.
stringID xs:string Attributo obbligatorio che specifica il testo da visualizzare nella posizione del carattere percentuale (%) nel testo del messaggio di notifica degli eventi. Il valore dell'attributo specifica la posizione della stringa di testo nella DLL della risorsa.
type xs:string No Attributo facoltativo che specifica il nome della stampante o del documento. Questo attributo può accettare uno dei valori seguenti: DocumentIl nome del documento da stampare. PrinterNameIl nome della stampante, come indicato nella cartella Stampanti e fax in Pannello di controllo, ad esempio "Fabrikam 5000 su \printserver" o "Stampante al piano superiore della camera da letto".

Elementi figlio

Non ci sono elementi figlio.

Elementi padre

Elemento Descrizione
Corpo Elemento obbligatorio che fornisce testo visualizzato nel messaggio di notifica degli eventi. Questo testo deve fornire dettagli specifici dell'utente sull'evento della stampante.
Titolo L'elemento titolo obbligatorio fornisce testo visualizzato nel titolo del messaggio di notifica degli eventi.

Commenti

Il testo caricato dalla DLL della risorsa può contenere caratteri percentuali (%) che verranno sostituiti con stringhe di testo specificate dall'elemento parametro .

Esempio

Nell'esempio di codice seguente viene illustrato come usare l'elemento del parametro per generare un messaggio di notifica degli eventi completo.

In questo esempio i valori stringID specificano quanto segue:

  • La stringa dell'interfaccia utente 100 nella DLL della risorsa driver è "Printer is out of %1 ink; aprire %2 e sostituire la stampante a penna."

  • La stringa dell'interfaccia utente 5 nella DLL dell'interfaccia utente fornita da Microsoft è "gialla".

  • La stringa dell'interfaccia utente 1002 nella DLL della risorsa driver è "Side AccessDoor 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>

Con il codice XML precedente, il testo del corpo seguente (stringID="100") viene visualizzato nel messaggio di notifica degli eventi: "Printer is out of yellow ink; aprire la porta di accesso laterale B e sostituire la stampante a penna."

Vedi anche

body

title