Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo argomento non è aggiornato. Per le informazioni più aggiornate, vedere Print Schema Specification.
Un elemento ParameterDef differisce da un elemento ParameterInit in quanto descrive il valore che un elemento ParameterInit può contenere, mentre un elemento ParameterInit assegna un valore al parametro . Un elemento ParameterDef è costituito da un set specifico di elementi Property, elementi figlio dell'elemento ParameterDef, che specificano il tipo di dati, massimo, minimo e valori predefiniti per i dati e altre informazioni. Questi elementi Property vengono descritti più avanti in questo argomento.
Gli elementi ParameterDef possono essere visualizzati solo nel contesto consentito. Per la versione iniziale dello schema di stampa, è possibile che si trovino a livello radice del documento PrintCapabilities. L'attributo name dell'elemento ParameterDef definisce il nome del parametro. A ogni elemento ParameterDef del documento PrintCapabilities deve essere assegnato un attributo di nome univoco.
Nota
per stampare i provider di documenti:
Il significato di un nome di parametro è universale; ovvero, se un elemento ParameterDef in un documento PrintCapabilities ha lo stesso attributo name (la stringa formata dallo spazio dei nomi e il nome descrittivo dell'elemento ParameterDef) come elemento ParameterDef in un altro documento PrintCapabilities, si presuppone che entrambi questi elementi rappresentino lo stesso concetto e debbano essere interpretati nello stesso modo. Pertanto, un elemento ParameterDef definito in un documento PrintTicket per un documento PrintCapabilities può essere usato per inizializzare l'elemento ParameterInit con lo stesso nome definito in un documento PrintCapabilities diverso.
Relazione con attributi XML
Poiché è true per tutti gli attributi del nome, il nome del parametro è sotto forma di QName XML. Un costrutto di parametro definito dallo schema ha un nome qualificato dallo spazio dei nomi pubblico, formando l'attributo name, mentre l'attributo name di un costrutto di parametro definito privatamente è qualificato da uno spazio dei nomi privato univoco per l'autore.
Relazione tra i tipi di elemento ParameterDef e property
Gli elementi ParameterDef definiti nelle parole chiave dello schema di stampa devono essere completamente definiti in un documento PrintCapabilities. Il documento Print Schema Keywords fornisce valori nominale per alcuni elementi Property di un elemento ParameterDef (ad esempio DefaultValue e altri), ma l'autore di un documento PrintCapabilities è responsabile della definizione degli elementi Property rimanenti. In ogni caso, tutti gli elementi Property devono essere definiti in modo esplicito in un elemento ParameterDef, inclusi quelli definiti nelle parole chiave dello schema di stampa.
Alcuni elementi Property di ogni elemento ParameterDef visualizzati nelle parole chiave dello schema di stampa sono designati come non modificabili. Ciò significa che tutte le definizioni di documento PrintCapabilities degli elementi ParameterDef definiti da Print Schema Keywords devono mantenere questi elementi Property senza modifiche. Questi elementi Property non modificabili consentono ai costrutti di parametri di essere portabili e non ambigui in tutti i documenti PrintCapabilities. Un esempio principale è rappresentato dalle unità usate in un elemento ParameterDef. Queste unità devono essere immutabili, per promuovere una comprensione coerente del loro significato. Gli elementi di proprietà di un ParameterDef designati come non non modificabili possono essere ridefiniti all'interno di un documento PrintCapabilities.
Un elemento ParameterDef è costituito dagli elementi Property seguenti. Tutti devono essere presenti, se non diversamente specificato.
| Nome proprietà | Valori | Descrizione | Immutabile? |
|---|---|---|---|
| Datatype |
numero intero decimale corda Nessun valore predefinito. |
Specifica se il valore del parametro è un numero intero, un numero a virgola mobile o una stringa di testo. Il valore di un parametro viene espresso nello stesso formato del tipo di dati di base XSD corrispondente; ovvero, come integer, decimale o stringa. |
Sì |
| DefaultValue |
Tipo specificato dalla proprietà DataType. Nessun valore predefinito. |
Specifica il valore con cui inizializzare un controllo dell'interfaccia utente.
|
No |
| Obbligatorio |
Non condizionale: l'elemento ParameterInit deve essere sempre fornito. Condizionale: l'elemento ParameterInit è obbligatorio solo se il parametro viene fatto riferimento all'interno di un elemento Option in un printticket. DefaultValue: condizionale. |
Indica quando un elemento ParameterInit deve essere visualizzato in modo esplicito. Se condizionale, l'oggetto ParameterInit deve essere inizializzato se PrintTicket contiene un'opzione che fa riferimento al parametro . Usato dai client dell'interfaccia utente e dai provider PrintCapabilities o PrintTicket. Si noti che in qualsiasi vincolo la proprietà obbligatoria dell'elemento ParameterDef deve essere impostata su Non condizionale. ParameterDef deve avere un valore definito. In caso contrario, non è stato possibile valutare il valore o il vincolo dipendente. |
No |
| MaxLength |
integer se la proprietà DataType specifica la stringa. DefaultValue: non viene applicato alcun valore massimo. |
Per i parametri con valori stringa, specifica la stringa consentita più lunga. L'interfaccia utente e i provider PrintCapabilities o PrintTicket usano questa proprietà per convalidare l'elemento ParameterDef. |
No |
| MaxValue |
integer se la proprietà DataType specifica l'intero. decimal se La proprietà DataType specifica decimale. DefaultValue: non viene applicato alcun valore massimo. |
Per gli elementi ParameterDef integer o decimal-valued, definisce il valore massimo consentito. |
No |
| MinLength |
integer se la proprietà DataType specifica la stringa. DefaultValue: non viene applicato alcun valore minimo. |
Per i valori stringa, definisce la stringa più breve consentita. L'interfaccia utente e i provider PrintCapabilities o PrintTicket usano questa proprietà per convalidare l'elemento ParameterDef. |
No |
| MinValue |
integer se la proprietà DataType specifica l'intero. decimal se La proprietà DataType specifica decimale. DefaultValue: non viene applicato alcun valore minimo. |
Per i parametri integer o decimal-valued, definisce il valore più piccolo consentito. |
No |
| Multiplo |
integer se la proprietà DataType specifica l'intero. decimal se La proprietà DataType specifica decimale. DefaultValue: 1 |
Per i parametri integer o decimal-valued, il valore del parametro deve essere un multiplo di questo numero. Per altre informazioni, vedere Note su più seguendo questa tabella. |
No |
| UnitType |
valore stringa che indica le unità utilizzate per il parametro . Nessun valore predefinito. |
Indica le unità in cui è espresso il parametro. Ad esempio, angoli in decimi di gradi, lunghezze inμs e così via. |
Sì |
Note su più
Per gli elementi ParameterInit con valori integer o decimali, il valore di ParameterInit deve essere un multiplo di questo numero. Ad esempio, gli elementi ParameterInit con valori decimali possono essere limitati ai decimi impostando questa proprietà su 0,1. Gli elementi dell'interfaccia utente usano questa proprietà quando creano dialoghi e controlli dell'interfaccia utente. Inoltre, il codice di convalida PrintTicket può utilizzare questa proprietà per arrotondare il valore di ParameterInit al valore più vicino indicato da Multiple. Nota: i driver di dispositivo e i provider PrintCapabilities non devono presupporre che i valori ParameterInit siano multipli di questo valore della proprietà. Ogni provider deve essere in grado di arrotondare valori arbitrari al valore utilizzabile più vicino a causa della possibilità che diversi provider possano specificare valori diversi e in conflitto per questa proprietà.