Proprietà (documenti e stampa)
Questo argomento non è aggiornato. Per le informazioni più aggiornate, vedere La specifica dello schema di stampa.
Un elemento Property dichiara un dispositivo, una formattazione del processo o un'altra proprietà pertinente il cui nome è assegnato dal relativo attributo name. Un elemento Value viene usato per assegnare un valore alla proprietà.
Una proprietà può essere complessa, possibilmente contenente più sottoproprietà. Le sottoproprietà sono rappresentate anche dagli elementi Property.
Tag elemento
<Proprietà>
Attributi XML
Nella tabella seguente sono elencati gli attributi XML che possono essere relativi a questo elemento.
| Attributo XML | Dettagli |
|---|---|
| name |
Contiene l'attributo name della proprietà, ovvero una proprietà standard o una proprietà definita privatamente. |
Per altre informazioni, vedere la sezione Attributi XML .
Informazioni sull'elemento
Nella tabella seguente sono elencati gli elementi che possono essere elementi padre di questo elemento, gli elementi che possono essere elementi figlio di questo elemento e le eventuali restrizioni sull'elemento stesso.
| Category | Dettagli |
|---|---|
| Elementi padre |
PrintCapabilities Funzionalità PrintTicket Opzione ParameterDef Proprietà ScoredProperty |
| Elementi figlio |
Il sistema non assegna alcun significato all'ordinamento degli elementi. Se i client scelgono di ascrivere un certo significato nell'ordinamento degli elementi, sono liberi di farlo. Proprietà (uno o più) Valore (zero o più) oppure Proprietà (zero o più) Valore (uno o più) |
| Questo elemento |
Non sono consentiti dati di tipo carattere. Sono consentiti elementi Value figlio duplicati di pari livello. |
Dipendenze di configurazione
Una proprietà può avere dipendenze di configurazione, tranne quando viene visualizzata all'interno di un elemento ParameterDef.
Utilizzo elementi
Oltre a essere visualizzati all'interno degli elementi Feature e Option, gli elementi Property possono essere visualizzati a livello radice delle rispettive tecnologie sottostanti. Lo schema di stampa definisce un set di elementi Property che possono essere utilizzati per descrivere un dispositivo in modo portabile. Tuttavia, se queste proprietà non sono sufficienti per le proprie esigenze come provider PrintCapabilities (in genere perché il dispositivo supportato ha nuovi aspetti non previsti dallo schema di stampa), è possibile introdurre i propri elementi Property privati. È possibile migliorare o elaborare le informazioni fornite da una proprietà pubblica aggiungendo una o più sottoproprietà private come contenuto dell'elemento della proprietà pubblica.
Gli elementi di proprietà vengono definiti utilizzando un tag di elemento XML, <Property>. A ogni proprietà viene assegnato un nome tramite il relativo attributo name. Il nome deve essere un QName XML e deve essere conforme alla Convenzione dello spazio dei nomi. Per informazioni dettagliate, vedere Attributi XML. L'attributo Nome proprietà e la relativa posizione all'interno della gerarchia degli elementi Property padre (se si tratta di una sottoproprietà) identificano in modo univoco la proprietà all'interno del documento PrintCapabilities o PrintTicket.
Una proprietà può contenere uno o più elementi Value o uno o più elementi Property figlio (denominati sottoproprietà) o una combinazione di entrambi. Le sottoproprietà sono utili quando la proprietà stessa è costituita da più componenti. Ad esempio, una proprietà "ConsumableColor" potrebbe avere componenti "C", "M" e "Y".
Esempio
<psf:Property name="psk:DisplayName">
<psf:Value xsi:type="xs:string">6</psf:Value>
</psf:Property>