パラメーター要素
省略可能なパラメーター要素は、イベント通知メッセージのテキストのパーセンテージ (%) 文字に置き換えるテキスト文字列を指定します。
パラメーター 要素は、この URI の asyncui 名前空間で定義されます。
https://schemas.microsoft.com/2003/print/asyncui/v1/request
このリソースは、一部の言語や国では利用できない場合があります。
使用方法
<parameter
stringID = "xs:string"
resourceDll = "xs:string"
type = "xs:string"/>
属性
| 属性 | Type | Required | 説明 |
|---|---|---|---|
| resourceDll | xs:string | いいえ | イベント通知メッセージに表示するテキストを含むリソース DLL を指定する省略可能な属性。 この DLL はプリンター ドライバーの依存ファイルであり、ドライバー リソース フォルダー (%SYSTEMROOT%\system32\spool\drivers\w32x86\3 など) に存在する必要があります。 |
| stringID | xs:string | はい | イベント通知メッセージのテキスト内のパーセント (%) 文字の位置に表示するテキストを指定する必須の属性。 属性値は、リソース DLL 内のテキスト文字列の場所を指定します。 |
| type | xs:string | いいえ | プリンターまたはドキュメントの名前を指定する省略可能な属性。 この属性は、次のいずれかの値を受け取ることができます :DocumentThe 出力されるドキュメントの名前。PrinterName プリンターの名前。たとえば、"\printserver の Fabrikam 5000" や "2 階のベッドルームのプリンター" など、コントロール パネルの [プリンターと FAX] フォルダーに表示されます。 |
子要素
子要素は存在しません。
親要素
| 要素 | 説明 |
|---|---|
| body | イベント通知メッセージに表示されるテキストを提供する必須の要素。 このテキストは、プリンター イベントに関するユーザー固有の詳細を提供する必要があります。 |
| title | イベント通知メッセージのタイトルに表示されるテキストを提供する必須のタイトル要素。 |
解説
リソース DLL から読み込まれたテキストには、パラメーター要素で指定されたテキスト文字列に置き換えられるパーセンテージ (%) 文字を含めることができます。
例
次のコード例は、パラメーター要素を使用して完全なイベント通知メッセージを生成する方法を示しています。
この例では、stringID 値で次の値を指定します。
ドライバー リソース DLL のユーザー インターフェイス文字列 100 が "プリンターが %1 インクから外れている。%2 を開き、インク カートリッジを交換してください。
Microsoft 提供のユーザー インターフェイス DLL のユーザー インターフェイス文字列 5 は "黄色" です。
ドライバー リソース 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 を開き、インクカートリッジを交換してください。