Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dieses Thema ist nicht aktuell. Die aktuellsten Informationen finden Sie in der Print Schema Specification.
Ein ParameterDef-Element unterscheidet sich von einem ParameterInit-Element darin, dass er den Wert beschreibt, den ein ParameterInit-Element enthalten kann, während ein ParameterInit-Element dem Parameter einen Wert zuweist. Ein ParameterDef-Element besteht aus einem bestimmten Satz von Property-Elementen, die untergeordnete Elemente des ParameterDef-Elements sind, die den Typ der Daten, das Maximum, das Minimum und die Standardwerte für die Daten und andere Informationen angeben. Diese Eigenschaftselemente werden weiter unten in diesem Thema erläutert.
ParameterDef-Elemente können nur im 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 Namensattribute zugewiesen werden.
Anmerkung
Zu Druckfunktionen Dokumentanbieter:
Die Bedeutung eines Parameternamens ist universell; d. h., wenn ein ParameterDef-Element in einem PrintCapabilities-Dokument dasselbe Namensattribute (die aus dem Namespace gebildete Zeichenfolge und den beschreibenden Namen des ParameterDef-Elements) als ParameterDef-Element in einem anderen PrintCapabilities-Dokument aufweist, wird davon ausgegangen, dass beide Elemente dasselbe Konzept darstellen und auf die gleiche Weise interpretiert werden sollten. Daher kann ein in einem PrintTicket für ein PrintCapabilities-Dokument definiertes ParameterDef-Element verwendet werden, um das ParameterInit-Element desselben Namens zu initialisieren, der in einem anderen PrintCapabilities-Dokument definiert ist.
Beziehung zu XML-Attributen
Wie bei allen Namensattributen gilt, befindet sich der Parametername in Form eines XML-QName.As is true of all name attributes, the parameter name is in form of an XML QName. Ein schemadefiniertes Parameterkonstrukt weist einen Namen auf, der vom öffentlichen Namespace qualifiziert ist und das Namensattribute bildet, während das Namensattribute eines privat definierten Parameterkonstrukts durch einen privaten Namespace qualifiziert wird, der für den Ersteller eindeutig ist.
Beziehung zwischen ParameterDef- und Eigenschaftselementtypen
ParameterDef-Elemente, die in den Druckschemastichwörtern definiert sind, müssen in einem PrintCapabilities-Dokument vollständig definiert sein. Das Dokument "Print Schema Keywords" stellt Nominalwerte für einige Eigenschaftselemente eines ParameterDef-Elements bereit (z. B. DefaultValue und andere), aber der Autor eines PrintCapabilities-Dokuments ist für die Definition der verbleibenden Property-Elemente verantwortlich. In jedem Fall müssen alle Property-Elemente in einem ParameterDef-Element explizit definiert werden, einschließlich der Elemente, die in den Printschemastichwörtern definiert sind.
Bestimmte Eigenschaftselemente der einzelnen ParameterDef-Elemente, die in den Print SchemaStichwörtern angezeigt werden, werden als unveränderlichenfestgelegt. Dies bedeutet, dass alle PrintCapabilities-Dokumentdefinitionen von "Print Schema Keywords-defined ParameterDef"-Elemente diese Property-Elemente ohne Änderung beibehalten müssen. Diese unveränderlichen Property-Elemente ermöglichen es den Parameterkonstrukten, portierbar und eindeutig in allen PrintCapabilities-Dokumenten zu sein. Ein prime example is the units used in a ParameterDef element. Diese Einheiten sollten unveränderlich sein, um ein einheitliches 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 nichts anderes angegeben ist.
| Eigenschaftsname | Werte | Beschreibung | Unveränderbar? |
|---|---|---|---|
| Datatype |
ganze Zahl dezimal Schnur Kein Standardwert. |
Gibt an, ob der Parameterwert eine ganze Zahl oder eine Gleitkommazahl oder eine Textzeichenfolge ist. Der Wert eines Parameters wird im gleichen Format wie der entsprechende XSD-Basisdatentyp ausgedrückt. d. h. als ganze Zahl, Dezimalzahl oder Zeichenfolge. |
Ja |
| DefaultValue |
Der durch die DataType-Eigenschaft angegebene Typ. Kein Standardwert. |
Gibt den Wert an, mit dem ein Benutzeroberflächensteuerelement initialisiert werden soll.
|
Nein |
| Obligatorisch |
Bedingungslos: Das ParameterInit-Element muss immer angegeben werden. Bedingung: Das ParameterInit-Element ist nur erforderlich, wenn innerhalb eines Option-Elements in einem PrintTicket auf den Parameter verwiesen wird. DefaultValue: Conditional. |
Gibt an, wann ein ParameterInit-Element explizit angezeigt werden muss. Wenn bedingt, muss der ParameterInit initialisiert werden, wenn das PrintTicket eine Option enthält, die auf den Parameter verweist. Wird von UI-Clients und PrintCapabilities- oder PrintTicket-Anbietern verwendet. Beachten Sie, dass in jeder Einschränkung die obligatorische Eigenschaft des ParameterDef-Elements auf Bedingungslos festgelegt werden muss. Der ParameterDef muss einen definierten Wert aufweisen, andernfalls konnte der abhängige Wert oder die Einschränkung nicht ausgewertet werden. |
Nein |
| MaxLength |
ganze Zahl, wenn DataType-Eigenschaft eine Zeichenfolge angibt. DefaultValue: Es wird kein Maximalwert erzwungen. |
Gibt für Zeichenfolgenwertparameter die längste zulässige Zeichenfolge an. Ui- und PrintCapabilities- oder PrintTicket-Anbieter verwenden diese Eigenschaft, um das ParameterDef-Element zu überprüfen. |
Nein |
| MaxValue |
ganze Zahl, wenn DataType-Eigenschaft ganze Zahl angibt. Dezimalzahl, wenn DataType-Eigenschaft das Dezimalzeichen angibt. DefaultValue: Es wird kein Maximalwert erzwungen. |
Für ganzzahlige oder dezimalwertige ParameterDef-Elemente wird der größte zulässige Wert definiert. |
Nein |
| MinLength |
ganze Zahl, wenn DataType-Eigenschaft eine Zeichenfolge angibt. DefaultValue: Es wird kein Minimalwert 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 |
ganze Zahl, wenn DataType-Eigenschaft ganze Zahl angibt. Dezimalzahl, wenn DataType-Eigenschaft das Dezimalzeichen angibt. DefaultValue: Es wird kein Minimalwert erzwungen. |
Definiert für ganzzahlige oder dezimalwertige Parameter den kleinsten zulässigen Wert. |
Nein |
| Mehrfach |
ganze Zahl, wenn DataType-Eigenschaft ganze Zahl angibt. Dezimalzahl, wenn DataType-Eigenschaft das Dezimalzeichen angibt. DefaultValue: 1 |
Bei ganzzahligen oder dezimalen Parametern sollte der Wert des Parameters ein Vielfaches dieser Zahl sein. Weitere Informationen finden Sie unter Hinweise zu mehreren nach dieser Tabelle. |
Nein |
| UnitType |
Zeichenfolgenwert, der die für den Parameter verwendeten Einheiten angibt. Kein Standardwert. |
Gibt die Einheiten an, in denen der Parameter ausgedrückt wird. Beispielsweise Winkel in Zehntel grad, Längen in Mikron usw. |
Ja |
Notizen zu mehreren
Bei ParameterInit-Elementen mit ganzzahligen oder dezimalen Werten sollte der Wert des ParameterInit ein Vielfaches dieser Zahl sein. Beispielsweise können ParameterInit-Elemente mit dezimalem Wert auf Zehntel beschränkt werden, indem sie diese Eigenschaft auf 0,1 festlegen. Ui-Elemente verwenden diese Eigenschaft, wenn sie Dialogfelder und UI-Steuerelemente erstellen. Darüber hinaus kann printTicket-Gültigkeitsprüfungscode 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 beliebige Werte auf den nächstgelegenen verwendbaren Wert runden können, da verschiedene Anbieter möglicherweise unterschiedliche und widersprüchliche Werte für diese Eigenschaft angeben können.