ParameterDef- und ParameterInit-Elemente

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

Ein ParameterDef-Element unterscheidet sich von einem ParameterInit-Element, da es den Wert beschreibt, den ein ParameterInit-Element enthalten kann, während ein ParameterInit-Element dem Parameter einen Wert zuteilt. Ein ParameterDef-Element besteht aus einem bestimmten Satz von Property-Elementen, die dem ParameterDef-Element untergestellt sind und den Datentyp, den Höchst-, Minimal- und Standardwert für die Daten sowie weitere Informationen angeben. Diese Property-Elemente werden weiter oben in diesem Thema erläutert.

ParameterDef-Elemente können nur in ihrem zulässigen Kontext angezeigt werden. Für die erste Version des Druckschemas befinden sie sich möglicherweise auf der Stammebene des PrintCapabilities-Dokuments. Das Name-Attribut des ParameterDef-Elements definiert den Parameternamen. Jedem ParameterDef-Element im PrintCapabilities-Dokument muss ein eindeutiges Namensattribut zugewiesen werden.

Hinweis

zum Drucken von Funktionen – Dokumentanbieter:

Die Bedeutung eines Parameternamens ist universell. Das heißt, wenn ein ParameterDef-Element in einem PrintCapabilities-Dokument das gleiche Namensattribut (die aus dem Namespace und dem beschreibenden Namen des ParametersDef-Elements gebildete Zeichenfolge) als ParameterDef-Element in einem anderen PrintCapabilities-Dokument hat, wird angenommen, dass beide Elemente das gleiche Konzept darstellen und auf die gleiche Weise interpretiert werden sollten. Daher kann ein ParameterDef-Element, das in einem PrintTicket für ein PrintCapabilities-Dokument definiert ist, verwendet werden, um das ParameterInit-Element mit demselben Namen zu initialisieren, das in einem anderen PrintCapabilities-Dokument definiert ist.

Beziehung zu XML-Attributen

Wie bei allen Namensattributen hat der Parametername die Form eines XML-QName. Ein schemadefiniertes Parameterkonstrukt verfügt über einen Namen, der durch den öffentlichen Namespace qualifiziert wird und das Namensattribut bildet, während das Name-Attribut eines privat definierten Parameterkonstrukts durch einen privaten Namespace qualifiziert wird, der für den Ersteller eindeutig ist.

Beziehung zwischen ParameterDef- und Property-Elementtypen

ParameterDef-Elemente, die in den Print Schema Keywords definiert sind, müssen vollständig in einem PrintCapabilities-Dokument definiert werden. Das Dokument Print Schema Keywords (Druckschemaschlüsselwörter) enthält nominale Werte für einige Property-Elemente eines ParameterDef-Elements (z. B. DefaultValue und andere), aber der Autor eines PrintCapabilities-Dokuments ist für das Definieren der verbleibenden Property-Elemente verantwortlich. In jedem Fall müssen alle Property-Elemente explizit in einem ParameterDef-Element definiert werden, einschließlich der elemente, die in den Schlüsselwörtern für Druckschemas definiert sind.

Bestimmte Property-Elemente der einzelnen ParameterDef-Elemente, die in den Druckschemaschlüsselwörtern angezeigt werden, werden als unveränderlich festgelegt. Dies bedeutet, dass alle PrintCapabilities-Dokumentdefinitionen von ParameterDef-Elementen, die mit "Print Schema Keywords" definiert sind, diese Property-Elemente ohne Änderungen beibehalten müssen. Diese unveränderlichen Property-Elemente ermöglichen es, dass die Parameterkonstrukte in allen PrintCapabilities-Dokumenten portierbar und eindeutig sind. Ein Primbeispiel sind die Einheiten, die in einem ParameterDef-Element verwendet werden. Diese Einheiten sollten unveränderlich sein, um ein konsistentes Verständnis ihrer Bedeutung zu fördern. Eigenschaftselemente einer ParameterDef, die als nicht unveränderlich festgelegt sind, können innerhalb eines PrintCapabilities-Dokuments neu definiert werden.

Ein ParameterDef-Element besteht aus den folgenden Property-Elementen. Alle müssen vorhanden sein, sofern nicht anders angegeben.

Eigenschaftsname Werte BESCHREIBUNG Unveränderlich?
DataType
integer
Decimal
Zeichenfolge
Für dieses Feld gibt es keinen Standardwert.
Gibt an, ob der Parameterwert eine ganze Zahl, eine Gleitkommazahl oder eine Textzeichenfolge ist. Der Wert eines Parameters wird im gleichen Format wie der entsprechende XSD-Basisdatentyp ausgedrückt. das heißt, als ganze Zahl, Dezimalzahl oder Zeichenfolge.
Ja
DefaultValue
Der von der DataType-Eigenschaft angegebene Typ.
Für dieses Feld gibt es keinen Standardwert.
Gibt den Wert an, mit dem ein Ui-Steuerelement initialisiert werden soll.
  • oder
Gibt den Wert an, der verwendet werden soll, wenn das relevante Parameterelement im PrintTicket fehlt.
Nein
Obligatorisch.
Bedingungslos: Das ParameterInit-Element muss immer angegeben werden.
Bedingt: Das ParameterInit-Element ist nur erforderlich, wenn in einem Option-Element in einem PrintTicket auf den Parameter verwiesen wird.
DefaultValue: Bedingt.
Gibt an, wenn ein ParameterInit-Element explizit angezeigt werden muss. Bei Bedingt muss ParameterInit initialisiert werden, wenn PrintTicket eine Option enthält, die auf den Parameter verweist.
Wird von Benutzeroberflächenclients und PrintCapabilities- oder PrintTicket-Anbietern verwendet. Beachten Sie, dass in jeder Einschränkung die Mandatory-Eigenschaft des ParameterDef-Elements auf Bedingungslos festgelegt werden muss. Die ParameterDef muss einen definierten Wert haben, andernfalls konnte der abhängige Wert oder die Einschränkung nicht ausgewertet werden.
Nein
MaxLength
integer, wenn die DataType-Eigenschaft eine Zeichenfolge angibt.
DefaultValue: Es wird kein Maximalwert erzwungen.
Für Zeichenfolgenwertparameter gibt die am längsten zulässige Zeichenfolge an. Ui- und PrintCapabilities- oder PrintTicket-Anbieter verwenden diese Eigenschaft, um das ParameterDef-Element zu überprüfen.
Nein
MaxValue
integer, wenn die DataType-Eigenschaft eine ganze Zahl angibt.
decimal, wenn die DataType-Eigenschaft decimal angibt.
DefaultValue: Es wird kein Maximalwert erzwungen.
Definiert für ParameterDef-Elemente mit ganzzahligen oder dezimalen Werten den größten zulässigen Wert.
Nein
Minlength
integer, wenn die DataType-Eigenschaft eine Zeichenfolge angibt.
DefaultValue: Es wird kein Mindestwert erzwungen.
Definiert für Zeichenfolgenwerte die kürzeste zulässige Zeichenfolge. Ui- und PrintCapabilities- oder PrintTicket-Anbieter verwenden diese Eigenschaft, um das ParameterDef-Element zu überprüfen.
Nein
Minvalue
integer, wenn die DataType-Eigenschaft eine ganze Zahl angibt.
decimal, wenn die DataType-Eigenschaft decimal angibt.
DefaultValue: Es wird kein Mindestwert erzwungen.
Definiert für Ganzzahl- oder Dezimalwertparameter den kleinsten zulässigen Wert.
Nein
Mehrere
integer, wenn die DataType-Eigenschaft eine ganze Zahl angibt.
decimal, wenn die DataType-Eigenschaft decimal angibt.
DefaultValue: 1
Bei Ganzzahl- oder Dezimalwertparametern sollte der Wert des Parameters ein Vielfaches dieser Zahl sein. Weitere Informationen finden Sie unter Hinweise zu mehreren in dieser Tabelle.
Nein
Unittype
Zeichenfolgenwert, der die für den Parameter verwendeten Einheiten angibt.
Für dieses Feld gibt es keinen Standardwert.
Gibt die Einheiten an, in denen der Parameter ausgedrückt wird. Beispielsweise Winkel in Zehntel grad, Längen in Mikrons und so weiter.
Ja

Hinweise zu mehreren

Für ParameterInit-Elemente mit ganzzahligen oder dezimalen Werten sollte der Wert von ParameterInit ein Vielfaches dieser Zahl sein. Beispielsweise können ParameterInit-Elemente mit Dezimalwert auf Zehntel beschränkt werden, indem sie diese Eigenschaft auf 0,1 festlegen. Benutzeroberflächenelemente verwenden diese Eigenschaft, wenn sie Dialoge und UI-Steuerelemente erstellen. Darüber hinaus kann der PrintTicket-Validierungscode diese Eigenschaft verwenden, um den Wert eines ParameterInit auf den nächsten Wert zu runden, der durch Multiple angegeben wird. Hinweis: Gerätetreiber und PrintCapabilities-Anbieter sollten nicht davon ausgehen, dass ParameterInit-Werte Vielfache dieses Eigenschaftswerts sind. Jeder Anbieter muss in der Lage sein, beliebige Werte auf den nächstgelegenen nutzbaren Wert zu runden. Dies liegt daran, dass verschiedene Anbieter unterschiedliche und in Konflikt stehende Werte für diese Eigenschaft angeben können.

Spezifikation des Druckschemas