共用方式為


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>

另請參閱

balloonUI

messageBoxUI

parameter