Liste de contrôle de construction de document PrintCapabilities
Cette rubrique n’est pas actuelle. Pour obtenir les informations les plus actuelles, consultez La spécification du schéma d’impression.
Le résumé des types d’éléments décrit les différents éléments qui composent un document PrintCapabilities. Cette section fournit une liste de contrôle que les auteurs de documents PrintCapabilities peuvent utiliser pour créer un document PrintCapabilities qui décrit un appareil.
Identifiez tous les attributs d’appareil qui contribuent à la configuration de l’appareil. Pour chaque attribut d’appareil de ce type, déterminez s’il doit être représenté en tant que construction de fonctionnalité/option ou en tant que construction de paramètre.
Pour chaque fonctionnalité d’appareil, déterminez si elle peut être représentée par une fonctionnalité définie dans les mots clés du schéma d’impression. Si ce n’est pas le cas, vous devez introduire une nouvelle fonctionnalité définie en privé (et un attribut de nom correspondant).
Pour Les instances de fonctionnalité définies par des mots clés de schéma d’impression, identifiez chacun des états disponibles sur ux finaux sur lequel cette fonctionnalité peut être définie. Chaque état correspond à une option du instance de fonctionnalité. Déterminez lequel de ces états correspond aux instances d’option d’impression définies par le schéma associées à cette fonctionnalité et quels états nécessitent une instance d’option personnalisée. La rubrique Définitions d’option présente des informations sur la construction de nouvelles instances d’option et la façon de dériver de nouvelles instances d’option à partir d’instances Option existantes.
Pour les instances de fonctionnalité non standard, identifiez les caractéristiques qui peuvent être utilisées pour distinguer une option d’une autre. Représentez chacune de ces caractéristiques par un élément ScoredProperty et, dans chaque instance d’option, affectez à chaque propriété ScoredProperty une valeur spécifique à cette option. Assurez-vous qu’il existe suffisamment d’éléments ScoredProperty pour que chaque option d’une fonctionnalité donnée soit unique. Les instances de fonctionnalité et d’option non standard sont par nature non portables. Autrement dit, un autre pilote ne sera pas en mesure de trouver une fonctionnalité ou une option équivalente pour correspondre à une fonctionnalité ou une option non standard spécifiée dans le PrintTicket que votre pilote crée.
Déterminez si une option doit contenir des éléments ParameterRef. Pour plus d’informations, consultez Constructions de paramètres et éléments de référence de paramètre.
Pour les paramètres, déterminez si l’une des instances ParameterDef définies dans les mots clés du schéma d’impression correspond à une correspondance adéquate. Si c’est le cas, copiez le instance ParameterDef à partir des mots clés du schéma d’impression et ajustez la valeur de chaque instance de propriété mutable pour qu’elle soit adaptée au mieux. Si aucune des instances ParameterDef dans Print Schema Keywords n’est appropriée, créez votre propre instance ParameterDef. Pour plus d’informations, consultez Paramètres dans le document PrintCapabilities.
Vérifiez que toutes les instances Property et ScoredProperty requises par le document Print Schema Keywords sont présentes dans votre document PrintCapabilities et qu’elles sont correctement initialisées.
Ajoutez des instances de propriété et de sous-propriété supplémentaires comme vous le souhaitez. Vous pouvez introduire des instances de propriété définies en privé si vous devez caractériser certains aspects de l’appareil qui ne sont pas couverts par les instances de propriété définies dans les mots clés du schéma d’impression.
Observez la convention d’espace de noms pour les attributs de nom. Cela s’applique aux attributs de nom définis en privé, ainsi qu’à ceux définis dans les mots clés de schéma d’impression.
Les enfants du même type d’élément ne peuvent pas imbriquer à une profondeur de plus de 10 éléments. Cette règle s’applique indépendamment à chaque type d’élément qui peut être défini.
Notez que les fonctionnalités d’impression documentent le contenu XML doit être encodé à l’aide de UTF-8 ou UTF-16.
Notez que l’ensemble d’instances Feature, Option et ParameterDef signalées ne doit pas changer, quelle que soit la instantané. Les instances ScoredProperty qui composent chaque option instance et la valeur attribuée à chaque élément ScoredProperty ne doivent pas non plus changer. Il en va de même pour les instances property qui composent chaque instance ParameterDef.
Pour obtenir la liste des instances de propriété supplémentaires qui doivent être fournies pour définir entièrement les constructions et paramètres de fonctionnalité/option, consultez ParameterDef et ParameterInit. Par exemple, chaque fonctionnalité doit spécifier son comportement d’interface utilisateur, en particulier si une ou plusieurs instances d’option peuvent être sélectionnées pour chaque fonctionnalité à la fois. Le document Mots clés du schéma d’impression définit ces instances de propriété, où elles doivent apparaître dans le document PrintCapabilities, et les instances Value définies dans les mots clés de schéma d’impression disponibles.
Le fournisseur PrintCapabilities est responsable de l’émission de la valeur appropriée pour toutes les instances de propriété dépendantes de la configuration. Par exemple, si le taux d’impression dépend à la fois du mode couleur et de la résolution utilisés, le fournisseur PrintCapabilities doit noter le mode de couleur et les paramètres de résolution spécifiés dans le PrintTicket fourni par le client, et doit indiquer la valeur appropriée pour le taux d’impression. Notez que chaque instance ScoredProperty doit avoir une valeur unique ; sa valeur instance ne peut pas changer lorsque la configuration de l’appareil change.
Notez également que les instances de propriété définies dans les mots clés de schéma d’impression doivent apparaître à l’emplacement spécifié. Ils ne peuvent pas apparaître à des emplacements arbitraires dans un document PrintCapabilities. Les instances de propriété définies en privé peuvent apparaître n’importe où, même en tant que sous-propriétés dans les instances de propriété définies par le schéma.
Notez qu’un conflit fonctionnel entre les paramètres est défini comme deux éléments de schéma d’impression non en conflit qui ont une fonction similaire, mais sont différentes. Par exemple, JobDuplexAllDocumentsContiguously et DocumentDuplex ; les deux représentent la fonction duplex de l’appareil, mais diffèrent dans l’application de la fonction, l’une s’appliquant à l’ensemble du travail de manière contiguë et l’autre aux documents. Dans le cas où deux éléments de ce type sont spécifiés, la priorité est déterminée par le producteur PrintCapabilities et le consommateur PrintTicket. Il incombe au producteur PrintCapabilities d’indiquer correctement les contraintes entre les éléments en conflit via l’attribut « contrainte ». Les éléments du schéma d’impression public qui présentent ce conflit sémantique sont identifiés dans leur définition.
Rubriques connexes