Propriété (documents et impression)

Cette rubrique n’est pas à jour. Pour obtenir les informations les plus récentes, consultez la spécification du schéma d’impression.

Un élément de propriété déclare un appareil, une mise en forme de travail ou une autre propriété pertinente dont le nom est donné par son attribut de nom. Un élément de valeur est utilisé pour assigner une valeur à la propriété.

Une propriété peut être complexe, contenant éventuellement plusieurs sous-propriétés. Les sous-propriétés sont également représentées par des éléments de propriété.

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 soit une propriété standard, soit 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 des parents de cet élément, les éléments qui peuvent être des enfants de cet élément, ainsi que toutes les restrictions applicables à 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 pas l’importance à l’ordre des éléments. Si les clients choisissent d’ascriber une certaine importance dans l’ordre des éléments, ils sont libres de le faire.
Property (une ou plusieurs) valeur (zéro ou plus)
ou
Valeur de la propriété (zéro ou plus) (un ou plusieurs)
Élément This
Aucune donnée de caractères n’est autorisée.
Les éléments de valeur enfants dupliqués qui sont des 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 de fonctionnalité et d’option, les éléments de propriété peuvent apparaître au niveau racine des technologies sous-jacentes respectives. Le schéma d’impression définit un ensemble d’éléments de propriété 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 a de nouveaux aspects non anticipés par le schéma d’impression), vous pouvez introduire vos propres éléments de propriété 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 de propriété 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 de nom de propriété et son emplacement dans la hiérarchie des éléments de propriété parents (s’il s’agit d’une sous-propriété) identifient de façon unique la propriété dans le document PrintCapabilities ou PrintTicket.

Une propriété peut contenir un ou plusieurs éléments de valeur, ou un ou plusieurs éléments de propriété 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é « ConsumableColor » 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>

Spécification du schéma d’impression