body 요소

아티클
08/08/2022
읽는 데 6분 걸림

필요한 본문 요소는 이벤트 알림 메시지에 표시되는 텍스트를 제공합니다. 이 텍스트는 프린터 이벤트에 대한 사용자별 세부 정보를 제공해야 합니다.

본문 요소는 다음 URI의 비동기 네임스페이스에 정의됩니다.

https://schemas.microsoft.com/2003/print/asyncui/v1/request

일부 언어 및 국가에서는 이 리소스를 사용할 수 없습니다.

사용량

<body
  stringID = "xs:string"
  resourceDll = "xs:string">
  child elements
</body>

특성

attribute	Type	필수	설명
resourceDll	xs:string	아니요	이벤트 알림 메시지에 표시할 본문 텍스트를 포함하는 리소스 DLL을 지정하는 선택적 특성입니다. 이 DLL은 프린터 드라이버의 종속 파일이어야 하며 드라이버 리소스 폴더에 있어야 합니다(예: %SYSTEMROOT%\system32\spool\drivers\w32x86\3).
stringID	xs:string	Yes	이벤트 알림 메시지의 본문에 표시할 텍스트를 지정하는 필수 특성입니다. 특성 값은 리소스 DLL에서 텍스트 문자열의 위치를 지정합니다.

resourceDll

xs:string

아니요

이벤트 알림 메시지에 표시할 본문 텍스트를 포함하는 리소스 DLL을 지정하는 선택적 특성입니다. 이 DLL은 프린터 드라이버의 종속 파일이어야 하며 드라이버 리소스 폴더에 있어야 합니다(예: %SYSTEMROOT%\system32\spool\drivers\w32x86\3).

stringID

xs:string

Yes

이벤트 알림 메시지의 본문에 표시할 텍스트를 지정하는 필수 특성입니다. 특성 값은 리소스 DLL에서 텍스트 문자열의 위치를 지정합니다.

자식 요소

요소	설명
매개 변수	본문 텍스트 사양에서 매개 변수를 대체하는 텍스트 문자열을 지정하는 선택적 요소입니다.

매개 변수

본문 텍스트 사양에서 매개 변수를 대체하는 텍스트 문자열을 지정하는 선택적 요소입니다.

부모 요소

요소	설명
balloonUI	클라이언트 컴퓨터에 메시지 풍선을 표시하는 데 사용되는 선택적 요소입니다.
messageBoxUI	클라이언트 컴퓨터에 메시지 상자를 표시하는 데 사용되는 선택적 요소입니다.

balloonUI

클라이언트 컴퓨터에 메시지 풍선을 표시하는 데 사용되는 선택적 요소입니다.

messageBoxUI

클라이언트 컴퓨터에 메시지 상자를 표시하는 데 사용되는 선택적 요소입니다.

설명

리소스 DLL에서 로드된 본문 텍스트에는 매개 변수 자식 요소에서 지정한 텍스트 문자열로 대체될 백분율(%) 태그가 포함될 수 있습니다.

여러 본문 태그를 순차적으로 사용할 수 있습니다. 이 경우 각각에 의해 생성된 텍스트가 이벤트 알림 메시지에 연결됩니다. 각 텍스트 문자열 쌍 사이에 공백이 삽입됩니다. "프린터가 잉크가 부족합니다."와 같은 상태 정보와 사용자에 대한 지침(예: "잉크 카트리지를 교체하고 프린터에서 다시 시작 단추를 눌러 계속 진행하세요.")과 같은 동일한 알림 메시지가 모두 표시할 수 있습니다.

본문 요소에 포함된 텍스트는 사용 가능한 작업을 사용자에게 알려야 합니다.

메시지 텍스트를 유용하고 간결하게 유지하려면 다음 권장 사항을 사용합니다.

문장 부호가 끝나는 전체 문장을 사용합니다.
다른 언어로 지역화할 때 255자 미만일 수 있는 본문 텍스트를 작성합니다. 예를 들어 영어로 된 메시지는 일반적으로 다른 언어로 지역화를 수용하기 위해 200자 이상을 사용하면 안 됩니다.
사용자가 특정 개체 이름, 사용자 이름, 파일 이름 또는 URL과 같은 요청된 작업을 완료할 수 있도록 하는 필수 정보를 포함합니다. 사용자는 이러한 정보를 찾기 위해 다른 창을 열 필요가 없습니다.
개체 이름 주위에 큰따옴표를 붙입니다(예: "용지함 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>

참고 항목

balloonUI

messageBoxUI

매개 변수