Freigeben über

XML-Attribute

  • Artikel

Dieses Thema ist nicht aktuell. Die aktuellsten Informationen finden Sie in der Print Schema Specification.

Es gibt eine Reihe von XML-Attributen, die in mehreren Elementtypen angezeigt werden, die im Print Schema Framework definiert sind. XML-Attribute mit demselben Namen haben im Allgemeinen die gleiche Bedeutung und befolgen dieselben Regeln unabhängig vom Elementtyp, in dem sie sich befinden. Daher werden die XML-Attribute hier anhand des Namens und nicht nach ihrem Hostelementtyp aufgeführt. Privat definierte XML-Attribute sind nicht zulässig. Nur die hier definierten XML-Attribute können in einem PrintCapabilities-Dokument oder einem PrintTicket und dann nur im definierten Kontext verwendet werden.

Private Parteien dürfen zwar keine neuen Definitionen in den Namespace einer anderen Partei einführen, aber sie dürfen vorhandene Namen aus einem anderen privaten Namespace verwenden, solange ihre Verwendung mit der von der anderen Partei festgelegten Verwendung übereinstimmt. Daher kann eine Option ScoredProperty-Elemente enthalten, die von mehreren verschiedenen Parteien definiert werden, die jeweils in verschiedenen Namespaces wohnen.

Attributname Datentypen und Werte Zweck Notizen
Name
XML-QName
 Dieses XML-Attribut identifiziert die Elementinstanz. Es unterscheidet ein Element von einem anderen desselben Elementtyps. Dieses XML-Attribut wird so häufig verwendet, dass es als Namensattribute bezeichnet wird.
 Die folgenden Einschränkungen beziehen sich auf das Namensattribute.
  • Das Name-Attribut muss in Form eines gültigen XML-definierten QName sein. Das heißt, sie muss durch einen gültigen XML-Namespace qualifiziert werden. Die QNames, die als Werte von Namensattributen angezeigt werden, müssen explizit namespacefähig sein, auch wenn ein Standardnamespace definiert ist.
  • Der Zeicheninhalt muss ein gültiger XML-definierter QName sein.
  • Privat definierte Namen müssen mit einem Namespace qualifiziert werden, der der Partei eindeutig zugeordnet ist, die das Namensattribute eingeführt hat.
  • Anforderung gleichgeordneter Eindeutigkeit: Keine zwei gleichgeordneten Elemente, die zum gleichen Elementtyp gehören, weisen möglicherweise dasselbe Namensattribute auf. Die einzige Ausnahme ist Option-Elemente, bei denen das Namensattribute zum Definieren einer Option verwendet werden kann. Daher haben mehrere gleichgeordnete Option-Elemente möglicherweise dasselbe Namensattribute.
  • Die folgenden Elementtypen können Namensattribute enthalten: Property, ScoredProperty, ParameterDef, Option und Feature.
  • Namenattribute müssen in jedem elementtyp angezeigt werden, der sie enthält, außer bei einigen zuvor definierten öffentlichen Printschemaoptionselementen, z. B. DocumentNUp.
Das folgende Beispiel zeigt, wie Sie eine Option-Instanz mithilfe eines Attributs "name" identifizieren. Dies ist die richtige Methode zum Definieren von Option-Elementen. Ein Anbieter sollte keine unbenannten Optionen haben, es sei denn, sie sind im Druckschema öffentlich definiert, z. B. 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>
verbreiten
Aufzählung
Zurzeit sind keine Werte definiert.
 Das Verteilungsattribut wird in der ursprünglichen Version des Print Schema Frameworks nicht verwendet. Es ist hier dokumentiert, sodass PrintCapabilities oder PrintTicket-Validierungscode, der für die ursprüngliche Version des Print Schema Framework implementiert wurde, alle nachfolgenden Schemaversionen ohne Fehler verarbeiten kann.
eingeschränkt
Aufzählung
Zulässige Werte:
  • Nichts
  • PrintTicketSettings
  • AdminSettings
  • DeviceSettings
Gibt an, ob die Option für die Auswahl oder für die Verwendung verfügbar ist.
Die zulässigen Werte des eingeschränkten Attributs haben die folgenden Bedeutungen. Beachten Sie, dass diese Werte in der Reihenfolge aufgeführt werden, von der geringsten Restriktiv (Keine) bis zu den restriktivsten (DeviceSettings).
Nichts
  • Die Option ist nicht eingeschränkt.
PrintTicketSettings
  • Die Option wird durch die PrintTicket-Einstellungen eingeschränkt. Dies bedeutet, dass das Ändern der Konfiguration die Einschränkung entfernen kann.
AdminSettings
  • Die Option wird durch die Einstellungen des Administrators eingeschränkt. die Option kann vom Benutzer nicht aktiviert werden.
DeviceSettings
  • Die Option wird durch die Geräteeinstellungen oder die physisch installierten Geräteoptionen eingeschränkt; die Option kann weder vom Benutzer noch vom Administrator aktiviert werden.
Wenn der PrintCapabilities-Anbieter Werte des eingeschränkten Attributs meldet, sollte die restriktivste Einschränkung gemeldet werden. Wenn beispielsweise eine Option durch eine Administratoreinstellung und eine Geräteeinstellung eingeschränkt wird, sollte der PrintCapabilities-Anbieter DeviceSettings melden.
xmlns
URI
 Dieses XML-Attribut stellt eine Verknüpfung zwischen einem Namespace uniform Resource Identifier (URI) und dem Namespacepräfix her, das im XML-QName angezeigt wird. Sie müssen eine solche Verknüpfung mit dem Namespace-URI einrichten, der für das Print Schema Framework definiert ist, bevor Sie eines der framework-definierten Elementtags, Attribute, Namensattribute usw. verwenden können. Sie können diesen Namespace als Standard deklarieren, um tatsächlich das Qualifizieren der Elementtags mit einem Namespacepräfix zu vermeiden, obwohl alle anderen QNames explizit qualifiziert sein müssen. Der Standardnamespace muss im entsprechenden Stammelement definiert werden. Beachten Sie alle XML-Regeln und Konventionen zur Verwendung des XMLns-Attributs.
Der URI für das Print Schema Framework ist http://schemas.microsoft.com/windows/2003/08/printing/printschemaframework.
Der URI für die Druckschemastichwörter lautet "https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords".