Propriété (Documents et impression)
Cette rubrique n’est pas à jour. Pour obtenir les informations les plus actuelles, consultez La spécification du schéma d’impression.
Un élément Property déclare un appareil, une mise en forme de travail ou une autre propriété pertinente dont le nom est donné par son attribut name. Un élément Value est utilisé pour affecter une valeur à property.
Une propriété peut être complexe et éventuellement 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 |
|---|---|
| name |
Contient l’attribut name de la propriété, qui est une propriété standard ou une propriété définie en privé. |
Pour plus d’informations, consultez la section Attributs XML .
Informations sur les éléments
Le tableau suivant répertorie les éléments qui peuvent être parents de cet élément, les éléments qui peuvent être des enfants de cet élément et toutes les restrictions sur l’élément lui-même.
| Category | Détails |
|---|---|
| Éléments parents |
PrintCapabilities Fonctionnalité 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) or Propriété (zéro ou plusieurs) Valeur (une ou plusieurs) |
| Cet élément |
Aucune donnée caractère n’est autorisée. Les éléments Value enfants en double 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 de l’élément
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 sont insuffisantes pour vos besoins en tant que fournisseur PrintCapabilities (généralement parce que l’appareil pris en charge présente de nouveaux aspects non prévus par le schéma d’impression), vous pouvez introduire vos propres éléments Property privés. Vous pouvez améliorer ou développer 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 property sont définis à l’aide d’une balise d’élément XML, <Property>. Un nom est attribué à chaque propriété au moyen de son attribut name. 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 parents (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>