body 元素
必要的 本文 元素會提供顯示在事件通知訊息中的文字。 此文字應提供印表機事件的使用者特定詳細數據。
主體項目定義在此 URI 的 asyncui 命名空間中:
https://schemas.microsoft.com/2003/print/asyncui/v1/request
某些語言和國家/地區可能無法使用此資源。
使用方式
<body
stringID = "xs:string"
resourceDll = "xs:string">
child elements
</body>
屬性
屬性 | 類型 | 必要 | Description |
---|---|---|---|
resourceDll | xs:string | No | 選擇性屬性,指定資源 DLL,其中包含要在事件通知訊息中顯示的本文。 此 DLL 應該是印表機驅動程式的相依檔案,而且必須存在於驅動程式資源資料夾中 (,例如%SYSTEMROOT%\system32\spool\drivers\w32x86\3) 。 |
stringID | xs:string | Yes | 必要屬性,指定要顯示在事件通知訊息本文中的文字。 屬性值會指定資源 DLL 中文字字串的位置。 |
子元素
元素 | Description |
---|---|
參數 | 選擇性專案,指定替代本文文字規格中參數的文字字串。 |
父元素
元素 | Description |
---|---|
balloonUI | 選擇性專案,用來在用戶端計算機上顯示訊息方塊。 |
messageBoxUI | 選擇性專案,用來在用戶端計算機上顯示消息框。 |
備註
從資源 DLL 載入的本文可以包含百分比 (%) 標記,以 參數 子專案所指定的文字字串取代。
您可以循序使用多個 本文 標記,在此情況下,每個產生的文字都會串連在事件通知訊息中。 每個文字字串組之間都會插入空格。 相同的通知訊息可以同時顯示:狀態資訊,例如「您的印表機不在筆墨中」,以及使用者的指示,例如「取代筆跡印表機並按印表機上的 [繼續] 按鈕以繼續」。
本文元素中包含的文字應該讓使用者知道可用的動作。
使用下列建議讓訊息文字保持實用且簡潔:
使用完整句子搭配結尾標點符號。
在當地語系化為其他語言時,撰寫少於 255 個字元的本文。 例如,英文的訊息通常不應該使用超過 200 個字元,以容納其他語言的當地語系化。
包含可讓使用者完成要求動作的基本資訊,例如特定物件名稱、使用者名稱、檔名或 URL。 用戶不應該開啟另一個視窗來尋找這類資訊。
將雙引號放在物件名稱周圍 (,例如“Paper Bin 1”) 。 不過,當物件名稱使用大寫字時,請勿使用引號,例如用戶名稱,它會與冒 (號位移,例如印表機名稱:我的印表機) ,或者可以輕鬆地從內容判斷。
如果您需要將物件名稱截斷為固定大小上限以容納當地語系化,請使用省略號 (...) 來表示截斷。
如果通知訊息提供使用者動作的按鈕,請確定訊息資訊與按鈕之間有兩個換行符。 使用簡單的動作導向片語標記按鈕,例如「按下以重新啟動列印」或「按下以查看詳細資訊」。
僅針對使用者可以自由忽略的非重要資訊使用通知訊息。 本文不應該說用戶必須執行動作。
如果使用者應該執行動作,請清楚描述執行動作的重要性和結果。
使用使用者如何修正問題的特定資訊,以純文本描述問題。
以與用戶相關的方式描述事件。 如果使用者因為通知而執行工作或變更行為,則通知訊息會相關。
根據用戶目標來描述事件,而不是技術問題。
範例
下列程式代碼範例示範如何使用 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>