XML-Attribute

Dieses Thema ist nicht aktuell. Die aktuellen Informationen finden Sie unter Print Schema Specification (Spezifikation des Druckschemas).

Es gibt eine Reihe von XML-Attributen, die in mehreren Elementtypen angezeigt werden, die im Druckschemaframework definiert sind. XML-Attribute mit demselben Namen haben in der Regel dieselbe Bedeutung und befolgen die gleichen Regeln, unabhängig vom Elementtyp, in dem sie sich befinden. Daher werden die XML-Attribute hier nach Name und nicht nach ihrem Hostelementtyp aufgelistet. 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, sie dürfen jedoch vorhandene Namen aus einem anderen privaten Namespace verwenden, solange ihre Verwendung mit der von der anderen Partei festgelegten Verwendung konsistent ist. Daher kann eine Option ScoredProperty-Elemente enthalten, die von mehreren verschiedenen Parteien definiert wurden, die sich jeweils in unterschiedlichen Namespaces befinden.

Attributname Datentypen und Werte Zweck Notizen
name
XML QName
Dieses XML-Attribut identifiziert die Elementinstanz. Es unterscheidet ein Element von einem anderen Element desselben Elementtyps. Dieses XML-Attribut wird so häufig verwendet, dass es als Namensattribut bezeichnet wird.
Die folgenden Einschränkungen gelten für das Name-Attribut.
  • Das Name-Attribut muss in Form eines gültigen XML-definierten QName-Werts 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 namespacequalifiziert sein, auch wenn ein Standardnamespace definiert ist.
  • Der Zeicheninhalt muss der eines gültigen XML-definierten QName sein.
  • Privat definierte Namen müssen mit einem Namespace qualifiziert werden, der eindeutig der Partei zugeordnet ist, die das Namensattribut eingeführt hat.
  • Anforderung an die gleichgeordnete Eindeutigkeit: Zwei gleichgeordnete Elemente, die zum gleichen Elementtyp gehören, dürfen nicht das gleiche Namensattribut haben. Die einzige Ausnahme sind Option-Elemente, bei denen das Name-Attribut verwendet werden kann, um eine Option zu definieren. Daher können mehrere gleichgeordnete Option-Elemente das gleiche Namensattribut haben.
  • Die folgenden Elementtypen können Namensattribute enthalten: Property, ScoredProperty, ParameterDef, Option und Feature.
  • Name-Attribute müssen in jedem element-Typ angezeigt werden, der sie enthält, mit Ausnahme einiger zuvor definierter öffentlicher Elemente der Druckschemaoption, z. B. DocumentNUp.
Das folgende Beispiel zeigt, wie Sie eine Option-Instanz mithilfe eines "name"-Attributs identifizieren. Dies ist die richtige Methode zum Definieren von Option-Elementen. Ein Anbieter sollte keine unbenannten Optionen haben, es sei denn, sie sind öffentlich im Druckschema definiert, z. B. DocumentNUp.
  
Eingeschränkt
Enumeration
Zulässige Werte:
  • Keine
  • PrintTicketSettings
  • AdminSettings
  • DeviceSettings
Gibt an, ob die Option zur Auswahl oder zur Verwendung verfügbar ist.
Die zulässigen Werte des eingeschränkten Attributs haben die folgende Bedeutung. Beachten Sie, dass diese Werte in der Reihenfolge aufgeführt sind, von der am wenigsten restriktiven (Keine) bis zur restriktivsten (DeviceSettings).
Keine
  • 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 optionen für physisch installierte Geräte 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 gefundene Einschränkung gemeldet werden. Wenn beispielsweise eine Option sowohl durch eine Administratoreinstellung als auch durch eine Geräteeinstellung eingeschränkt wird, sollte der PrintCapabilities-Anbieter DeviceSettings melden.
xmlns
URI
Dieses XML-Attribut erstellt eine Verknüpfung zwischen einem Namespace-URI (Uniform Resource Identifier) und dem Namespacepräfix, das im XML QName angezeigt wird. Sie müssen einen solchen Link zu dem Namespace-URI einrichten, der für das Druckschemaframework definiert ist, bevor Sie eines der Framework-definierten Elementtags, Attribute, Namensattribute und so weiter verwenden können. Sie können diesen Namespace als Standardnamespace deklarieren, um zu vermeiden, dass die Elementtags tatsächlich mit einem Namespacepräfix qualifiziert werden, obwohl alle anderen QNames explizit qualifiziert werden müssen. Der Standardnamespace muss im entsprechenden Stammelement definiert werden. Beachten Sie alle XML-Regeln und -Konventionen in Bezug auf die Verwendung des xmlns-Attributs.
Der URI für das Druckschemaframework ist http://schemas.microsoft.com/windows/2003/08/printing/printschemaframework .
Der URI für die Druckschemaschlüsselwörter ist https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords .

Spezifikation des Druckschemas