Compartir a través de

Atributos XML

Este tema no está actualizado. Para obtener la información más reciente, consulte el Especificación de esquema de impresión .

Hay una serie de atributos XML que aparecen en varios tipos de elementos definidos en el marco de esquema de impresión. Los atributos XML con el mismo nombre suelen tener el mismo significado y obedecer las mismas reglas independientemente del tipo de elemento en el que residen. Por lo tanto, los atributos XML se enumeran aquí por nombre y no por su tipo de elemento host. No se permiten atributos XML definidos de forma privada. Solo los atributos XML definidos aquí se pueden usar en un documento PrintCapabilities o printTicket y, a continuación, solo en el contexto definido.

Aunque no se permite a las partes privadas introducir nuevas definiciones en el espacio de nombres de otra entidad, se les permite utilizar nombres existentes de otro espacio de nombres privado siempre que su uso sea coherente con el uso establecido por la otra parte. Por lo tanto, una opción puede contener elementos ScoredProperty definidos por varias partes diferentes, cada una de las cuales reside en diferentes espacios de nombres.

Nombre del atributo Tipos de datos y valores Propósito Notas
nombre
XML QName
 Este atributo XML identifica la instancia de elemento. Distingue un elemento de otro del mismo tipo de elemento. Este atributo XML es tan ampliamente utilizado como atributo name.
 Las restricciones siguientes pertenecen al atributo name.
  • El atributo name debe estar en forma de un QName definido por XML válido. Es decir, debe calificarse mediante un espacio de nombres XML válido. Los QNames que aparecen como valores de atributos de nombre deben estar calificados explícitamente para el espacio de nombres, incluso si se define un espacio de nombres predeterminado.
  • El contenido de caracteres debe ser el de un QName definido por XML válido.
  • Los nombres definidos de forma privada deben calificarse con un espacio de nombres que esté asociado de forma única a la entidad que introdujo el atributo name.
  • Requisito de unicidad del mismo nivel: no puede haber dos elementos del mismo nivel que pertenezcan al mismo tipo de elemento. La única excepción es los elementos Option, donde se puede usar el atributo name para definir una opción. Por lo tanto, los elementos Option de varios elementos del mismo nivel pueden tener el mismo atributo de nombre.
  • Los siguientes tipos de elementos pueden contener atributos de nombre: Property, ScoredProperty, ParameterDef, Option y Feature.
  • Se requieren atributos name para que aparezcan en cada uno de los tipos de elemento que los contienen, excepto en el caso de algunos elementos public Print Schema Option definidos previamente, como DocumentNUp.
En el ejemplo siguiente se muestra cómo identificar una instancia de Option mediante un atributo "name". Esta es la manera correcta de definir elementos Option. Un proveedor no debe tener opciones sin nombre, a menos que se definan públicamente en el esquema de impresión, como 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>
propagar
Enumeración
Actualmente no se define ningún valor.
 El atributo propagate no se usa en la versión inicial del marco de esquema de impresión. Aquí se documenta para que printCapabilities o el código de validación printTicket implementado para la versión inicial de Print Schema Framework pueda procesar cualquier versión de esquema posterior sin errores.
encogido
Enumeración
Valores permitidos:
  • Ninguno
  • PrintTicketSettings
  • AdminSettings
  • DeviceSettings
Indica si la opción está disponible para la selección o para su uso.
Los valores permitidos del atributo restringido tienen los significados siguientes. Tenga en cuenta que estos valores se enumeran en orden, de menos restrictivo (Ninguno) a más restrictivo (DeviceSettings).
Ninguno
  • La opción no está restringida.
PrintTicketSettings
  • La opción está restringida por la configuración de PrintTicket. Esto implica que cambiar la configuración puede quitar la restricción.
AdminSettings
  • La opción está restringida por la configuración del administrador; el usuario no puede habilitar la opción.
DeviceSettings
  • La opción está restringida por la configuración del dispositivo o las opciones de dispositivo instaladas físicamente; el usuario o el administrador no pueden habilitar la opción.
Cuando el proveedor PrintCapabilities notifica los valores del atributo restringido, se debe notificar la restricción más restrictiva. Por ejemplo, si una opción está restringida por una configuración de administrador y una configuración de dispositivo, el proveedor PrintCapabilities debe notificar DeviceSettings.
xmlns
URI
 Este atributo XML establece un vínculo entre un identificador uniforme de recursos de espacio de nombres (URI) y el prefijo de espacio de nombres que aparece en el QName XML. Debe establecer este vínculo al URI del espacio de nombres definido para print Schema Framework antes de poder usar cualquiera de las etiquetas de elemento definidas por framework, atributos, atributos, atributos de nombre, etc. Puede declarar este espacio de nombres para que sea el valor predeterminado para evitar calificar realmente las etiquetas de elemento con un prefijo de espacio de nombres, aunque todos los demás QNames deben estar calificados explícitamente. El espacio de nombres estándar debe definirse en el elemento raíz adecuado. Observe todas las reglas y convenciones XML con respecto al uso del atributo xmlns.
El URI del marco de esquema de impresión es http://schemas.microsoft.com/windows/2003/08/printing/printschemaframework.
El URI de las palabras clave del esquema de impresión es "https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords".

de especificación de esquema de impresión de