body 요소
필수 본문 요소는 이벤트 알림 메시지에 표시되는 텍스트를 제공합니다. 이 텍스트는 프린터 이벤트에 대한 사용자별 세부 정보를 제공해야 합니다.
본문 요소는 다음 URI의 비동기 네임스페이스에 정의됩니다.
https://schemas.microsoft.com/2003/print/asyncui/v1/request
일부 언어 및 국가에서는 이 리소스를 사용할 수 없습니다.
사용량
<body
stringID = "xs:string"
resourceDll = "xs:string">
child elements
</body>
특성
attribute | Type | 필수 | 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")에 큰따옴표를 붙입니다. 그러나 개체 이름이 사용자 이름과 같이 대문자로 표시된 단어를 사용하거나 콜론으로 오프셋되거나(예: 프린터 이름: 내 프린터) 컨텍스트에서 쉽게 확인할 수 있는 경우 따옴표를 사용하지 마세요.
지역화를 수용하기 위해 개체 이름을 고정된 최대 크기로 잘라내야 하는 경우 줄임표(...)를 사용하여 잘림을 나타냅니다.
알림 메시지가 사용자 작업에 대한 단추를 제공하는 경우 메시지 정보와 단추 사이에 두 줄 바꿈이 있는지 확인합니다. 단추에 "인쇄를 다시 시작하려면 클릭" 또는 "추가 정보를 보려면 클릭"과 같은 간단한 동작 지향 구문으로 레이블을 지정합니다.
사용자가 자유롭게 무시할 수 있는 중요하지 않은 정보에 대해서만 알림 메시지를 사용합니다. 본문 텍스트는 사용자가 작업을 수행해야 한다고 말하면 안 됩니다.
사용자가 작업을 수행해야 하는 경우 작업 수행의 중요성과 결과를 명확하게 설명합니다.
사용자가 문제를 해결하는 방법에 대한 특정 정보를 사용하여 일반 언어로 문제를 설명합니다.
사용자와 관련된 방식으로 이벤트를 설명합니다. 알림 메시지는 사용자가 알림의 결과로 작업을 수행하거나 동작을 변경할 수 있는 합리적인 기회가 있는 경우 관련이 있습니다.
기술적인 문제가 아닌 사용자 목표 측면에서 이벤트를 설명합니다.
예제
다음 코드 예제에서는 본문 요소를 사용 하는 방법을 보여 줍니다.
<?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>