Propriété (documents et impression)
Cette rubrique n’est pas actuelle. Pour plus d’informations, consultez la spécification de schéma d’impression.
Un élément Property déclare un appareil, une mise en forme de tâche ou une autre propriété pertinente dont le nom est donné par son attribut de nom. Un élément Value est utilisé pour affecter une valeur à la propriété.
Une propriété peut être complexe, pouvant contenir plusieurs sous-propriétés. Les sous-propriétés sont également représentées par les éléments Property.
Balise d’élément
<, propriété>
Attributs XML
Le tableau suivant répertorie les attributs XML qui peuvent être liés à cet élément.
| Attribut XML | Détails |
|---|---|
| nom |
Contient l’attribut de nom de la propriété, qui est une propriété standard ou une propriété définie en privé. |
Pour plus d’informations, consultez section Attributs XML.
Informations sur l’élément
Le tableau suivant répertorie les éléments qui peuvent être parents de cet élément, les éléments qui peuvent être enfants de cet élément et toutes les restrictions sur l’élément lui-même.
| Catégorie | Détails |
|---|---|
| Éléments parents |
PrintCapabilities Caractéristique PrintTicket Option ParameterDef Propriété ScoredProperty |
| Éléments enfants |
Le système n’affecte aucune importance au classement des éléments. Si les clients choisissent d’attribuer une certaine importance dans l’ordre des éléments, ils sont libres de le faire. , propriété (une ou plusieurs) valeur (zéro ou plusieurs) ou Propriété (zéro ou plusieurs) Valeur (une ou plusieurs) |
| Cet élément |
Aucune donnée de caractère n’est autorisée. Les éléments Value enfants dupliqués qui sont frères sont autorisés. |
Dépendances de configuration
Une propriété peut avoir des dépendances de configuration, sauf lorsqu’elle apparaît dans un élément ParameterDef.
Utilisation des éléments
En plus d’apparaître dans les éléments Feature et Option, les éléments Property peuvent apparaître au niveau racine des technologies sous-jacentes respectives. Le schéma d’impression définit un ensemble d’éléments Property qui peuvent être utilisés pour décrire un appareil de manière portable. Toutefois, si ces propriétés ne sont pas suffisantes pour vos besoins en tant que fournisseur PrintCapabilities (généralement parce que l’appareil pris en charge comporte de nouveaux aspects non anticipés par le schéma d’impression), vous pouvez introduire vos propres éléments de propriété privée. Vous pouvez améliorer ou élaborer les informations fournies par une propriété publique en ajoutant une ou plusieurs sous-propriétés privées en tant que contenu d’élément de la propriété publique.
Les éléments de propriété sont définis à l’aide d’une balise d’élément XML, <Property>. Chaque propriété reçoit un nom au moyen de son attribut de nom. Le nom doit être un QName XML et doit être conforme à la convention d’espace de noms. Pour plus d’informations, consultez attributs XML. L’attribut Property name et son emplacement dans la hiérarchie des éléments Property parent (s’il s’agit d’une sous-propriété) identifient de manière unique la propriété dans le document PrintCapabilities ou PrintTicket.
Une propriété peut contenir un ou plusieurs éléments Value, ou un ou plusieurs éléments Property enfants (appelés sous-propriétés) ou une combinaison des deux. Les sous-propriétés sont utiles lorsque la propriété elle-même est composée de plusieurs composants. Par exemple, une propriété « ConsommableColor » peut avoir des composants « C », « M » et « Y ».
Exemple
<psf:Property name="psk:DisplayName">
<psf:Value xsi:type="xs:string">6</psf:Value>
</psf:Property>