XML 属性

  • 项目

此主题不是最新的。 有关最新信息，请参阅打印架构规范。

打印架构框架中定义的多种元素类型中出现了许多 XML 属性。 具有相同名称的 XML 属性通常具有相同的含义并遵循相同的规则，无论它们驻留在何种元素类型中。 因此，XML 属性按名称列出，而不是按其主机元素类型列出。 不允许使用以专用方式定义的 XML 属性。 只有此处定义的 XML 属性可以在 PrintCapability 文档或 PrintTicket 中使用，并且只能在定义的上下文中使用。

尽管不允许专用方将新定义引入另一方的命名空间，但允许他们使用另一个专用命名空间中的现有名称，只要其用法与另一方建立的用法一致即可。 因此，Option 可能包含由多个不同参与方定义的 ScoredProperty 元素，每个元素驻留在不同的命名空间中。

属性名称 数据类型和值 目的 说明
name
XML QName
 此 XML 属性标识元素实例。 它可将一个元素与同一元素类型的另一个元素区分开来。 此 XML 属性使用非常广泛，因此被称为名称属性。
 以下限制与名称属性有关。
  • 名称属性必须采用 XML 定义的有效 QName 形式。 也就是说，它必须由有效的 XML 命名空间限定。 即使定义了默认命名空间，作为名称属性的值显示的 QName 也必须由命名空间显式限定。
  • 字符内容必须是 XML 定义的有效 QName。
  • 以专用方式定义的名称必须使用与引入名称属性的参与方唯一关联的命名空间进行限定。
  • 同级唯一性要求：属于同一元素类型的两个同级元素可能具有相同的名称属性。 唯一的例外是 Option 元素，其中名称属性可用于定义 Option。 因此，多同级 Option 元素可能具有相同的名称属性。
  • 以下元素类型可能包含名称属性：Property、ScoredProperty、ParameterDef、Option 和 Feature。
  • 名称属性必须出现在包含它们的每个元素类型中，但之前定义的公共打印架构 Option 元素（如 DocumentNUp）除外。
以下示例演示如何使用名称属性标识 Option 实例。 这是定义 Option 元素的正确方法。 提供程序不应具有未命名的 Option，除非它们在打印架构（如 DocumentNUp）中公开定义。
  <psf:Option name="psk:StapleBottomRight">
    \<psf:ScoredProperty name="psk:Angle">
      <psf:Value xsi:type="xs:integer">_Undefined_<psf:Value>
    </psf:ScoredProperty>
    <psf:ScoredProperty name="psk:SheetCapacity" >
      <psf:Value xsi:type="xs:integer">_Undefined_<psf:Value>
    <psf:ScoredProperty>
  </psf:Option>
propagate
枚举
当前未定义任何值。
 打印架构框架的初始版本不使用 propagate 属性。 此处列出此属性的目的是，使为打印架构框架的初始版本实现的 PrintCapability 或 PrintTicket 验证代码可以处理任何后续架构版本而不会出现错误。
constrained
枚举
允许的值：
  • 无
  • PrintTicketSettings
  • AdminSettings
  • DeviceSettings
指示 Option 是可用于选择还是可供使用。
受约束属性允许的值具有以下含义。 请注意，这些值按宽松 (None) 到严格 (DeviceSettings) 的顺序列出。
无
  • Option 不受约束。
PrintTicketSettings
  • Option 受 PrintTicket 设置的约束。 这意味着更改配置可以删除约束。
AdminSettings
  • Option 受管理员的设置约束；用户无法启用 Option。
DeviceSettings
  • Option 受设备设置或物理安装的设备选项的约束；用户或管理员都无法启用 Option。
当 PrintCapabilities 提供程序报告受约束属性的值时，应报告最严格的约束。 例如，如果 Option 受管理员设置和设备设置的约束，PrintCapabilities 提供程序应报告 DeviceSettings。
xmlns
URI
 此 XML 属性在命名空间统一资源标识符 (URI) 与 XML QName 中显示的命名空间前缀之间建立链接。 必须先建立指向为打印架构框架定义的命名空间 URI 的此类链接，然后才能使用任何框架定义的元素标记、属性、名称属性等。 可将此命名空间声明为默认值，以避免实际限定具有命名空间前缀的元素标记，尽管所有其他 QName 都必须进行显式限定。 必须在相应的根元素中定义标准命名空间。 观察有关使用 xmlns 属性的所有 XML 规则和约定。
打印架构框架的 URI 为 http://schemas.microsoft.com/windows/2003/08/printing/printschemaframework.
打印架构关键字的 URI 为 `https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords`。

打印架构规范