précédent | suivant | table des matières

Impressions en Java : les attributs

Lors de l'impression sur une imprimante, ou lors de la configuration d'un travail d'impression, l'utilisateur peut spécifier comment se fait cette impression ou cette configuration à l'aide d'ensembles d'attributs.

L'API Java Print Service contient deux paquetages :

• javax.print.attribute le paquetage qui contient les interfaces et classes qui décrivent le type des attributs et comment ils sont rassemblés dans des ensembles.
• javax.print.attribute.standard le paquetage qui énumère tous les attributs standards de l'API. La plupart de ces attributs correspondent aux attributs définis par Internet Printing Protocol (IPP).

Catégorie, valeur

Chaque imprimante a des fonctionnalités, telles que l'impression sur différents format de page, l'impression de plusieurs copies, l'impression en couleur, l'orientation de l'impression, etc...

Chaque fonctionnalité a un ensembles de valeurs possibles :

• [A0, A1, ... A4, ....] pour le format de page.
• un nombre entier pour le nombre de copies.
• [COLOR, MONOCHROME] pour l'impression en couleur ou en noir et blanc.
• [landscape, portrait, reverse landscape] pour l'orientation.
• ...

L'API Java Print Service nomme catégorie une fonctionnalité d'imprimante, et valeur, la valeur de la fonctionnalité.

• Une catégorie est une classe implémentant l'interface Attribute.

• Une valeur est une instance de cette classe ou d'une sous-classe, ou une constante de la classe :
  • new Copies(5) pour 5 copies.
  • Chromaticity.COLOR pour la couleur.

L'interface Attribute définit deux méthodes :

String getName()

Class getCategory()

Rôles des attributs

5 rôle différents sont définis pour les attributs, à l'aide de 5 sous-interfaces de l'interface Attribute :

• PrintRequestAttribute les réglages pour le job d'impression dans son ensemble.
• DocAttribute les réglage pour un seul document.
• PrintJobAttribute
• PrintServiceAttribute est utilisé pour obtenir le statut d'une imprimante.
• SupportedValuesAttribute est utilisé par une imprimante pour donner les valeurs légales d'un attribut.

De nombreux attributs peuvent jouer plusieurs rôles : par exemple, l'attribut Media a trois rôles différents DocAttribute, PrintJobAttribute et PrintRequestAttribute.

L'interface ci-dessous visualise les attributs d'une imprimante. Les rôles de chaque attribut sont spécifiés dans la colonne de gauche, dans l'ordre suivant : 

• PrintRequestAttribute
• DocAttribute
• PrintJobAttribute
• PrintServiceAttribute
• SupportedValuesAttribute

Ensemble d'attributs

On crée un ensemble d'attributs en utilisant l'une des quatre interfaces

• DocAttributeSet qui contient des DocAttributes et est implantée par la classe HashDocAttributeSet.
• PrintRequestAttributeSet qui contient des PrintRequestAttributes et est implantée par la classe HashPrintRequestAttributeSet.
• PrintJobAttributeSet qui contient des containing PrintJobAttributes et est implantée par la classe HashPrintJobAttributeSet.
• PrintServiceAttributeSet qui contient des PrintServiceAttributes et est implantée par la classe HashPrintServiceAttributeSet.

Exemple :

HashPrintRequestAttributeSet prs = new HashPrintRequestAttributeSet();   
prs.add(DialogTypeSelection.COMMON); // COMMON pour le dialogue Java
                                     // NATIVE pour le dialogue Système                  
prs.add(OrientationRequested.LANDSCAPE); // LANDSCAPE orientation paysage
                                         // PORTRAIT orientation portrait 
                                         // REVERSE_LANDSCAPE ou REVERSE_PORTRAIT
prs.add(new PageRanges(1,15)); // Pour sélectionner les pages de 1 à 15
                               // On peut également sélectionner des groupes de pages.
prs.add(new copies(3)); // Pour avoir 3 copies 
prs.add(Chromaticity.MONOCHROME); // en noir et blanc ou COLOR 
prs.add(Sides.ONE_SIDED); // mode normal
                          // TWO_SIDED_LONG_EDGE, ou DUPLEX : deux pages dans la largeur
                          // TWO_SIDED_LSHORT_EDGE, ou TUMBLE : deux pages dans la hauteur
prs.add(PrintQuality.NORMAL); // HIGH, DRAFT ou NORMAL
prs.add(new JobPriority(5)); // priorité du job d'impression
try {
   // Pour sélectionner un fichier de destination
   prs.add(new Destination(new URI("xxx")));
} catch (URISyntaxException e) {}
...

La hiérarchie des classes et interfaces concernées par les attributs est la suivante :

haut de la page