Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Ten temat nie jest aktualny. Aby uzyskać najbardziej aktualne informacje, zobacz Print Schema Specification.
Element ParameterDef różni się od elementu ParameterInit, ponieważ opisuje wartość, którą może zawierać element ParameterInit, podczas gdy element ParameterInit przypisuje wartość do parametru. Element ParameterDef składa się z określonego zestawu elementów właściwości, które są elementami podrzędnymi elementu ParameterDef, które określają typ danych, maksimum, minimum i wartości domyślne dla danych oraz inne informacje. Te elementy właściwości zostały omówione w dalszej części tego tematu.
Elementy parameterDef mogą być wyświetlane tylko w ich dozwolonym kontekście. W przypadku początkowej wersji schematu wydruku mogą one znajdować się na poziomie głównym dokumentu PrintCapabilities. Atrybut name elementu ParameterDef definiuje nazwę parametru. Każdy element ParameterDef w dokumencie PrintCapabilities musi mieć przypisany unikatowy atrybut name.
Nuta
aby drukować, dostawcy dokumentów:
Znaczenie nazwy parametru jest uniwersalne; oznacza to, że jeśli element ParameterDef w jednym dokumencie PrintCapabilities ma ten sam atrybut nazwy (ciąg utworzony z przestrzeni nazw i opisową nazwę elementu ParameterDef) jako element ParameterDef w innym dokumencie PrintCapabilities, zakłada się, że oba te elementy reprezentują tę samą koncepcję i powinny być interpretowane w ten sam sposób. W związku z tym element ParameterDef zdefiniowany w elemecie PrintTicket dla jednego dokumentu PrintCapabilities może służyć do inicjowania elementu ParameterInit o tej samej nazwie zdefiniowanej w innym dokumencie PrintCapabilities.
Relacja z atrybutami XML
Podobnie jak w przypadku wszystkich atrybutów nazwy, nazwa parametru jest w postaci nazwy QName XML. Konstrukcja parametru zdefiniowanego schematem ma nazwę kwalifikowaną przez publiczną przestrzeń nazw, tworząc atrybut name, podczas gdy atrybut nazwy konstrukcji parametru zdefiniowanego prywatnie jest kwalifikowany przez prywatną przestrzeń nazw, która jest unikatowa dla twórcy.
Relacja między parametramiDef i typami elementów właściwości
Elementy ParametrDef zdefiniowane w słowach kluczowych schematu wydruku muszą być w pełni zdefiniowane w dokumencie PrintCapabilities. Dokument Print Schema Keywords (Słowa kluczowe schematu wydruku) zawiera wartości nominalne dla niektórych elementów właściwości elementu ParameterDef (na przykład DefaultValue i innych), ale autor dokumentu PrintCapabilities jest odpowiedzialny za zdefiniowanie pozostałych elementów właściwości. W każdym razie wszystkie elementy właściwości muszą być jawnie zdefiniowane w elemecie ParameterDef, w tym te, które są zdefiniowane w słowach kluczowych schematu wydruku.
Niektóre elementy właściwości każdego elementu ParameterDef wyświetlane w słowach kluczowych schematu wydruku są oznaczone jako niezmienne. Oznacza to, że wszystkie definicje dokumentów PrintCapabilities zdefiniowane przez słowa kluczowe schematu wydruku ParametryDef muszą zachować te elementy właściwości bez modyfikacji. Te niezmienne elementy właściwości umożliwiają przenośne i jednoznaczne konstrukcje parametrów we wszystkich dokumentach PrintCapabilities. Doskonałym przykładem są jednostki używane w elemecie ParameterDef. Te jednostki powinny być niezmienne, aby promować spójne zrozumienie ich znaczenia. Elementy właściwości parametruDef, które są oznaczone jako niezmienialne, mogą być ponownie zdefiniowane w dokumencie PrintCapabilities.
Element ParameterDef składa się z następujących elementów właściwości. Wszystkie muszą być obecne, chyba że zaznaczono inaczej.
| Nazwa właściwości | Wartości | Opis | Niezmienialny? |
|---|---|---|---|
| Datatype |
liczba całkowita dziesiętny struna Brak wartości domyślnej. |
Określa, czy wartość parametru jest liczbą całkowitą, liczbą zmiennoprzecinkową, czy ciągiem tekstowym. Wartość parametru jest wyrażona w tym samym formacie co odpowiedni podstawowy typ danych XSD; oznacza to, że jako liczba całkowita, dziesiętna lub ciąg. |
Tak |
| DefaultValue |
Typ określony przez właściwość DataType. Brak wartości domyślnej. |
Określa wartość, za pomocą której należy zainicjować kontrolkę interfejsu użytkownika.
|
Nie |
| Obowiązkowy |
Bezwarunkowe: należy zawsze podać element ParameterInit. Warunkowe: element ParameterInit jest wymagany tylko wtedy, gdy parametr jest przywołyny w elemencie Option w elemencie PrintTicket. DefaultValue: warunkowe. |
Wskazuje, kiedy element ParameterInit musi pojawić się jawnie. Jeśli parametr ParametrInit musi zostać zainicjowany, jeśli printTicket zawiera opcję odwołującą się do parametru. Używane przez klientów interfejsu użytkownika i dostawców PrintCapabilities lub PrintTicket. Należy pamiętać, że w każdym ograniczeniu właściwość Obowiązkowe elementu ParameterDef musi być ustawiona na Wartość Bezwarunkowa. ParametrDef musi mieć zdefiniowaną wartość, w przeciwnym razie nie można ocenić wartości zależnej lub ograniczenia. |
Nie |
| MaxLength |
Liczba całkowita, jeśli właściwość DataType określa ciąg. DefaultValue: nie jest wymuszana wartość maksymalna. |
W przypadku parametrów o wartości ciągu określa najdłuższy dozwolony ciąg. Interfejs użytkownika i dostawcy PrintCapabilities lub PrintTicket używają tej właściwości do sprawdzania poprawności elementu ParameterDef. |
Nie |
| MaxValue |
Liczba całkowita, jeśli właściwość DataType określa liczbę całkowitą. liczba dziesiętna, jeśli właściwość DataType określa wartość dziesiętną. DefaultValue: nie jest wymuszana wartość maksymalna. |
W przypadku elementów parametrów parametrów o wartości całkowitej lub dziesiętnej definiuje największą dozwoloną wartość. |
Nie |
| MinLength |
Liczba całkowita, jeśli właściwość DataType określa ciąg. DefaultValue: nie jest wymuszana wartość minimalna. |
W przypadku wartości ciągów definiuje najkrótszy dozwolony ciąg. Interfejs użytkownika i dostawcy PrintCapabilities lub PrintTicket używają tej właściwości do sprawdzania poprawności elementu ParameterDef. |
Nie |
| MinValue |
Liczba całkowita, jeśli właściwość DataType określa liczbę całkowitą. liczba dziesiętna, jeśli właściwość DataType określa wartość dziesiętną. DefaultValue: nie jest wymuszana wartość minimalna. |
W przypadku parametrów liczb całkowitych lub dziesiętnych definiuje najmniejszą dozwoloną wartość. |
Nie |
| Wielokrotny |
Liczba całkowita, jeśli właściwość DataType określa liczbę całkowitą. liczba dziesiętna, jeśli właściwość DataType określa wartość dziesiętną. DefaultValue: 1 |
W przypadku parametrów liczb całkowitych lub dziesiętnych wartość parametru powinna być wielokrotną liczbą. Aby uzyskać więcej informacji, zobacz Uwagi dotyczące wielu poniżej tej tabeli. |
Nie |
| Typ jednostki |
wartość ciągu wskazująca jednostki używane dla parametru. Brak wartości domyślnej. |
Wskazuje jednostki, w których wyrażono parametr. Na przykład kąty w dziesiątych stopniach, długości w mikronach itd. |
Tak |
Uwagi dotyczące wielu
W przypadku elementów ParameterInit z wartościami całkowitymi lub dziesiętnymi wartość ParametrInit powinna być wielokrotną liczbą. Na przykład elementy ParameterInit o wartości dziesiętnej mogą być ograniczone do dziesiątych, ustawiając tę właściwość na 0,1. Elementy interfejsu użytkownika używają tej właściwości podczas konstruowania okien dialogowych i kontrolek interfejsu użytkownika. Ponadto kod weryfikacji PrintTicket może użyć tej właściwości, aby zaokrąglić wartość parametru do najbliższej wartości wskazanej przez wiele. Uwaga: Sterowniki urządzeń i dostawcy PrintCapabilities nie powinni zakładać, że wartości ParametrInit są wielokrotnością tej wartości właściwości. Każdy dostawca musi być w stanie zaokrąglić dowolne wartości do najbliższej wartości możliwej do użycia ze względu na możliwość, że różni dostawcy mogą określić różne i powodujące konflikty wartości dla tej właściwości.