參數項目
選擇性 參數元素 會指定文字字串,該字串會取代事件通知訊息文字中的百分比 (%) 字元。
參數項目定義在此 URI 的 asyncui 命名空間中:
https://schemas.microsoft.com/2003/print/asyncui/v1/request
某些語言和國家/地區可能無法使用此資源。
使用方式
<parameter
stringID = "xs:string"
resourceDll = "xs:string"
type = "xs:string"/>
屬性
屬性 | 類型 | 必要 | Description |
---|---|---|---|
resourceDll | xs:string | No | 選擇性屬性,指定資源 DLL,其中包含要在事件通知訊息中顯示的文字。 此 DLL 應該是印表機驅動程式的相依檔案,而且必須存在於驅動程式資源資料夾中 (,例如%SYSTEMROOT%\system32\spool\drivers\w32x86\3) 。 |
stringID | xs:string | Yes | 必要屬性,指定要顯示在事件通知訊息文字中百分比 (%) 字元的位置。 屬性值會指定資源 DLL 中文字字串的位置。 |
type | xs:string | No | 選擇性屬性,指定印表機或檔的名稱。 此屬性可以採用下列其中一個值:Document 要列印的文件名稱。PrinterName 印表機的名稱,如 控制台 中的 Printer and Faxes 資料夾所列,例如“Fabrikam 5000 on \printserver” 或 “Printer in printer in 控制台”。 |
子元素
沒有子專案。
父元素
元素 | Description |
---|---|
身體 | 必要元素,提供事件通知訊息中顯示的文字。 此文字應提供印表機事件的使用者特定詳細數據。 |
標題 | 必要的 title 元素會提供顯示在事件通知訊息標題中的文字。 |
備註
從資源 DLL 載入的文字可以包含百分比 (%) 字元,這些字元將會取代為 參數 元素所指定的文字字串。
範例
下列程式代碼範例示範如何使用 參數 項目來產生完整的事件通知訊息。
在此範例中, stringID 值會指定下列專案:
驅動程式資源 DLL 中的使用者介面字串 100 是「印表機來自 %1 筆跡;請開啟 %2 並取代筆跡擷取。」
Microsoft 提供的使用者介面 DLL 中的使用者介面字串 5 為 “yellow”。
驅動程序資源 DLL 中的使用者介面字串 1002 是「側邊存取門 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>
使用上述 XML 程式代碼時,下列本文 (stringID=「100」) 會顯示在事件通知訊息中:「印表機不足黃色筆跡;請開啟側邊存取門 B,並取代筆跡擷取。」