다음을 통해 공유


ParameterDef 및 ParameterInit 요소

이 항목은 현재 항목이 아닙니다. 최신 정보는 인쇄 스키마 사양참조하세요.

ParameterDef 요소는 ParameterInit 요소가 포함할 수 있는 값을 설명하는 반면 ParameterInit 요소는 매개 변수에 값을 할당한다는 점에서 ParameterInit 요소와 다릅니다. ParameterDef 요소는 데이터에 대한 데이터 형식, 최대값, 최소값 및 기본값 및 기타 정보를 지정하는 ParameterDef 요소의 자식인 특정 속성 요소 집합으로 구성됩니다. 이러한 속성 요소는 이 항목의 뒷부분에서 설명합니다.

ParameterDef 요소는 허용된 컨텍스트에서만 나타날 수 있습니다. 초기 버전의 인쇄 스키마의 경우 PrintCapabilities 문서의 루트 수준에 있을 수 있습니다. ParameterDef 요소의 이름 특성은 매개 변수 이름을 정의합니다. PrintCapabilities 문서의 각 ParameterDef 요소에는 고유한 이름 특성이 할당되어야 합니다.

메모

기능 문서 공급자를 인쇄하려면 다음을 수행합니다.

매개 변수 이름의 의미는 범용입니다. 즉, 한 PrintCapabilities 문서의 ParameterDef 요소에 다른 PrintCapabilities 문서의 ParameterDef 요소와 동일한 이름 특성(네임스페이스에서 형성된 문자열 및 ParameterDef 요소의 설명이 포함된 이름)이 있는 경우 이러한 두 요소가 동일한 개념을 나타내며 동일한 방식으로 해석되어야 한다고 가정합니다. 따라서 한 PrintCapabilities 문서에 대해 PrintTicket에 정의된 ParameterDef 요소를 사용하여 다른 PrintCapabilities 문서에 정의된 동일한 이름의 ParameterInit 요소를 초기화할 수 있습니다.

XML 특성에 대한 관계

모든 이름 특성의 경우와 마찬가지로 매개 변수 이름은 XML QName 형식입니다. 스키마 정의 매개 변수 구문에는 public 네임스페이스로 한정된 이름이 있으며, 이름 특성을 형성하는 반면, 비공개로 정의된 매개 변수 구문의 이름 특성은 작성자에 고유한 프라이빗 네임스페이스에 의해 정규화됩니다.

ParameterDef와 Property 요소 형식 간의 관계

인쇄 스키마 키워드에 정의된 ParameterDef 요소는 PrintCapabilities 문서에서 완전히 정의되어야 합니다. 인쇄 스키마 키워드 문서는 ParameterDef 요소의 일부 속성 요소(예: DefaultValue 및 기타)에 대한 명목 값을 제공하지만 PrintCapabilities 문서의 작성자는 나머지 속성 요소를 정의합니다. 모든 속성 요소는 인쇄 스키마 키워드에 정의된 요소를 포함하여 ParameterDef 요소에 명시적으로 정의되어야 합니다.

인쇄 스키마 키워드에 표시되는 각 ParameterDef 요소의 특정 속성 요소는 변경할 수 없는 지정됩니다. 즉, 인쇄 스키마 키워드 정의 ParameterDef 요소의 모든 PrintCapabilities 문서 정의는 수정 없이 이러한 속성 요소를 유지해야 합니다. 이러한 변경할 수 없는 속성 요소를 사용하면 모든 PrintCapabilities 문서에서 매개 변수 구문을 이식 가능하고 명확하게 지정할 수 있습니다. 대표적인 예는 ParameterDef 요소에 사용되는 단위입니다. 이러한 단위는 변경이 불가능해야 의미에 대한 일관된 이해를 촉진할 수 있습니다. 변경할 수 없는 것으로 지정된 ParameterDef의 속성 요소는 PrintCapabilities 문서 내에서 다시 정의될 수 있습니다.

ParameterDef 요소는 다음 속성 요소로 구성됩니다. 달리 명시되지 않는 한 모든 항목이 있어야 합니다.

속성 이름 묘사 불변의?
DataType
정수
십진법
문자열
기본값이 없습니다.
매개 변수 값이 정수인지 부동 소수점 숫자인지 또는 텍스트 문자열인지를 지정합니다. 매개 변수의 값은 해당 XSD 기본 데이터 형식과 동일한 형식으로 표현됩니다. 즉, 정수, 10진수 또는 문자열입니다.

DefaultValue
DataType 속성에 지정된 형식입니다.
기본값이 없습니다.
UI(사용자 인터페이스) 컨트롤을 초기화할 값을 지정합니다.
  • 또는
PrintTicket에서 관련 매개 변수 요소가 누락된 경우 사용할 값을 지정합니다.
아니요
필수
무조건: ParameterInit 요소는 항상 제공되어야 합니다.
조건부: ParameterInit 요소는 PrintTicket의 Option 요소 내에서 매개 변수를 참조하는 경우에만 필요합니다.
DefaultValue: 조건부입니다.
ParameterInit 요소가 명시적으로 표시되어야 하는 경우를 나타냅니다. 조건부인 경우 PrintTicket에 매개 변수를 참조하는 Option이 포함된 경우 ParameterInit를 초기화해야 합니다.
UI 클라이언트 및 PrintCapabilities 또는 PrintTicket 공급자에서 사용됩니다. 모든 제약 조건에서 ParameterDef 요소의 Mandatory 속성은 무조건으로 설정해야 합니다. ParameterDef에는 정의된 값이 있어야 합니다. 그렇지 않으면 종속 값 또는 제약 조건을 평가할 수 없습니다.
아니요
MaxLength
DataType 속성이 문자열을 지정하는 경우 정수입니다.
DefaultValue: 최대값은 적용되지 않습니다.
문자열 반환 매개 변수의 경우 허용되는 가장 긴 문자열을 지정합니다. UI 및 PrintCapabilities 또는 PrintTicket 공급자는 이 속성을 사용하여 ParameterDef 요소의 유효성을 검사합니다.
아니요
MaxValue
DataType 속성이 정수로 지정하는 경우 정수입니다.
DataType 속성이 10진수를 지정하는 경우 10진수입니다.
DefaultValue: 최대값은 적용되지 않습니다.
정수 또는 10진수 값 ParameterDef 요소의 경우 허용되는 가장 큰 값을 정의합니다.
아니요
MinLength
DataType 속성이 문자열을 지정하는 경우 정수입니다.
DefaultValue: 최소값이 적용되지 않습니다.
문자열 값의 경우 허용되는 가장 짧은 문자열을 정의합니다. UI 및 PrintCapabilities 또는 PrintTicket 공급자는 이 속성을 사용하여 ParameterDef 요소의 유효성을 검사합니다.
아니요
MinValue
DataType 속성이 정수로 지정하는 경우 정수입니다.
DataType 속성이 10진수를 지정하는 경우 10진수입니다.
DefaultValue: 최소값이 적용되지 않습니다.
정수 또는 10진수 값 매개 변수의 경우 허용되는 가장 작은 값을 정의합니다.
아니요
배수
DataType 속성이 정수로 지정하는 경우 정수입니다.
DataType 속성이 10진수를 지정하는 경우 10진수입니다.
DefaultValue: 1
정수 또는 10진수 값 매개 변수의 경우 매개 변수 값은 이 숫자의 배수여야 합니다. 자세한 내용은 이 표 다음의 여러 참고를 참조하세요.
아니요
UnitType
매개 변수에 사용되는 단위를 나타내는 문자열 값입니다.
기본값이 없습니다.
매개 변수가 표현되는 단위를 나타냅니다. 예를 들어 10분의 1 각도, 미크론의 길이 등입니다.

다중에 대한 참고 사항

정수 또는 10진수 값이 있는 ParameterInit 요소의 경우 ParameterInit 값은 이 숫자의 배수여야 합니다. 예를 들어 10진수 값 ParameterInit 요소는 이 속성을 0.1로 설정하여 10분의 1로 제한할 수 있습니다. UI 요소는 대화 상자 및 UI 컨트롤을 생성할 때 이 속성을 사용합니다. 또한 PrintTicket 유효성 검사 코드는 이 속성을 사용하여 ParameterInit 값을 Multiple로 표시된 가장 가까운 값으로 반올림할 수 있습니다. 참고: 디바이스 드라이버 및 PrintCapabilities 공급자는 ParameterInit 값이 이 속성 값의 배수라고 가정해서는 안 됩니다. 각 공급자는 서로 다른 공급자가 이 속성에 대해 서로 다르고 충돌하는 값을 지정할 수 있어 임의의 값을 가장 가까운 사용 가능한 값으로 반올림할 수 있어야 합니다.

인쇄 스키마 사양