elemento corpo
L'elemento corpo obbligatorio fornisce testo visualizzato nel messaggio di notifica dell'evento. Questo testo deve fornire dettagli specifici dell'utente sull'evento della stampante.
L'elemento corpo è 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
<body
stringID = "xs:string"
resourceDll = "xs:string">
child elements
</body>
Attributi
| Attributo | Type | Obbligatoria | Descrizione |
|---|---|---|---|
| resourceDll | xs:string | No | Attributo facoltativo che specifica una DLL di risorse contenente il testo del corpo da visualizzare nel messaggio di notifica dell'evento. Questa DLL deve essere un file dipendente del driver della stampante e deve essere presente nella cartella della risorsa driver, ad esempio %SYSTEMROOT%\system32\spool\drivers\w32x86\3. |
| stringID | xs:string | Sì | Attributo obbligatorio che specifica il testo da visualizzare nel corpo del messaggio di notifica dell'evento. Il valore dell'attributo specifica il percorso della stringa di testo nella DLL della risorsa. |
Elementi figlio
| Elemento | Descrizione |
|---|---|
| Parametro | Elemento facoltativo che specifica stringhe di testo che sostituiscono i parametri in una specifica del testo del corpo. |
Elementi padre
| Elemento | Descrizione |
|---|---|
| balloonUI | Elemento facoltativo usato per visualizzare un palloncino di messaggi nel computer client. |
| messageBoxUI | Elemento facoltativo utilizzato per visualizzare una finestra di messaggio nel computer client. |
Commenti
Il testo del corpo caricato dalla DLL della risorsa può contenere tag percentuale (%) che verranno sostituiti con stringhe di testo specificate dall'elemento figlio del parametro .
È possibile usare più tag del corpo in sequenza, nel qual caso il testo generato da ogni oggetto verrà concatenato nel messaggio di notifica dell'evento. Verrà inserito uno spazio tra ogni coppia di stringhe di testo. Lo stesso messaggio di notifica può visualizzare entrambe le informazioni sullo stato, ad esempio "La stampante è fuori penna".
Il testo contenuto nell'elemento corpo deve consentire all'utente di conoscere l'azione disponibile.
Usare i consigli seguenti per mantenere il testo del messaggio utile e conciso:
Usare frasi complete con punteggiatura finale.
Comporre il testo del corpo che può essere minore di 255 caratteri quando localizzato in altre lingue. Ad esempio, un messaggio in inglese non deve in genere usare più di 200 caratteri per supportare la localizzazione in altre lingue.
Includere informazioni essenziali che consentono all'utente di completare un'azione richiesta, ad esempio nomi di oggetti specifici, nomi utente, nomi di file o URL. Gli utenti non devono aprire un'altra finestra per trovare tali informazioni.
Inserire virgolette doppie intorno ai nomi degli oggetti , ad esempio "Paper Bin 1"). Tuttavia, non usare virgolette quando il nome dell'oggetto usa parole maiuscole, ad esempio un nome utente, è offset con un punto (ad esempio, Nome stampante: Stampante) o può essere facilmente determinato dal contesto.
Se è necessario troncare i nomi degli oggetti in una dimensione massima fissa per supportare la localizzazione, usare i puntini di sospensione (...) per indicare il troncamento.
Se un messaggio di notifica fornisce un pulsante per l'azione dell'utente, assicurarsi che siano presenti due interruzioni di riga tra le informazioni del messaggio e il pulsante. Etichettare il pulsante con frasi semplici orientate all'azione, ad esempio "Fare clic per riavviare la stampa" o "Fare clic per visualizzare altre informazioni".
Usare solo i messaggi di notifica per informazioni non critiche che l'utente può ignorare liberamente. Il testo del corpo non deve dire che l'utente deve eseguire un'azione.
Se l'utente deve eseguire un'azione, descrivere chiaramente l'importanza e le conseguenze dell'esecuzione dell'azione.
Descrivere i problemi in linguaggio normale con informazioni specifiche su come l'utente può risolvere il problema.
Descrivere l'evento in modo rilevante per l'utente. Un messaggio di notifica è rilevante se esiste una ragionevole probabilità che un utente esegua un'attività o cambierà il comportamento in seguito alla notifica.
Descrivere un evento in termini di obiettivi utente, anziché in termini di problemi tecnologici.
Esempio
Nell'esempio di codice seguente viene illustrato come usare l'elemento corpo .
<?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>