매개 변수 요소
선택적 매개 변수 요소는 이벤트 알림 메시지의 텍스트에서 백분율(%) 문자로 대체되는 텍스트 문자열을 지정합니다.
매개 변수 요소는 다음 URI의 비동기 네임스페이스에 정의됩니다.
https://schemas.microsoft.com/2003/print/asyncui/v1/request
일부 언어 및 국가에서는 이 리소스를 사용할 수 없습니다.
사용량
<parameter
stringID = "xs:string"
resourceDll = "xs:string"
type = "xs:string"/>
특성
| attribute | Type | 필수 | Description |
|---|---|---|---|
| resourceDll | xs:string | No | 이벤트 알림 메시지에 표시할 텍스트가 포함된 리소스 DLL을 지정하는 선택적 특성입니다. 이 DLL은 프린터 드라이버의 종속 파일이어야 하며 드라이버 리소스 폴더에 있어야 합니다(예: %SYSTEMROOT%\system32\spool\drivers\w32x86\3). |
| stringID | xs:string | Yes | 이벤트 알림 메시지 텍스트의 백분율(%) 문자 위치에 표시할 텍스트를 지정하는 필수 특성입니다. 특성 값은 리소스 DLL에서 텍스트 문자열의 위치를 지정합니다. |
| type | xs:string | No | 프린터 또는 문서의 이름을 지정하는 선택적 특성입니다. 이 특성은 다음 값 중 하나를 사용할 수 있습니다. Document 인쇄되는 문서의 이름입니다. PrinterName제어판 프린터 및 팩스 폴더에 나열된 프린터의 이름입니다(예: "\printserver의 Fabrikam 5000" 또는 "위층 침실의 프린터"). |
자식 요소
자식 요소가 없습니다.
부모 요소
| 요소 | Description |
|---|---|
| 몸 | 이벤트 알림 메시지에 표시되는 텍스트를 제공하는 필수 요소입니다. 이 텍스트는 프린터 이벤트에 대한 사용자별 세부 정보를 제공해야 합니다. |
| 제목 | 필수 제목 요소는 이벤트 알림 메시지의 제목에 표시되는 텍스트를 제공합니다. |
설명
리소스 DLL에서 로드된 텍스트에는 매개 변수 요소로 지정된 텍스트 문자열로 대체될 백분율(%) 문자가 포함될 수 있습니다.
예제
다음 코드 예제에서는 매개 변수 요소를 사용하여 전체 이벤트 알림 메시지를 생성하는 방법을 보여줍니다.
이 예제에서 stringID 값은 다음을 지정합니다.
드라이버 리소스 DLL의 사용자 인터페이스 문자열 100은 "프린터가 %1 잉크를 벗어났습니다. %2를 열고 잉크 카트리지를 교체하세요."
Microsoft에서 제공하는 사용자 인터페이스 DLL의 사용자 인터페이스 문자열 5는 "노란색"입니다.
드라이버 리소스 DLL의 사용자 인터페이스 문자열 1002는 "Side Access Door 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")가 표시됩니다. "프린터가 노란색 잉크가 부족합니다. Side Access Door B를 열고 잉크 카트리지를 교체하세요."