Par exemple, le code suivant utilise une occurrence de PrintUIOptions pour spécifier le nombre maximal et minimal de pages lors de l’affichage de la boîte de dialogue Mise en page :
Cette constante s’utilise avec la propriété
Cette constante s’utilise avec la propriété
Cette constante s’utilise avec la propriété
Si le contenu à imprimer comprend une image bitmap, réglez la propriété
Remarque : Adobe AIR ne prend pas en charge l’impression vectorielle sous Mac OS.
Le paramètre de résolution s’applique à l’impression bitmap et à l’impression vectorielle. Pour l’impression bitmap, la résolution détermine la manière dont la totalité de la page est rastérisée. Pour l’impression vectorielle, la résolution détermine la manière dont le contenu spécifique, tels que les images bitmaps et les dégradés, est rastérisé.
Si le contenu à imprimer comprend une image bitmap, réglez
Par exemple, pour imprimer le contenu sous forme de bitmap, utilisez la syntaxe suivante :
Remarque : Adobe AIR ne prend pas en charge l’impression vectorielle sous Mac OS.
Remarque : le traitement des erreurs est très limité dans cet exemple.
Définissez cette propriété sur l’une des valeurs suivantes dans la classe
Si la méthode printMethod est définie sur l’une de ces valeurs prises en charge, printAsBitmap est ignorée.
La valeur par défaut est
Prise en charge du navigateur mobile : cette classe n’est pas prise en charge sur les navigateurs mobiles.
Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur tous les systèmes d’exploitation de bureau, mais ne l’est pas sur les périphériques mobiles ou sur les périphériques AIR pour TV. Vous pouvez tester la prise en charge lors de l’exécution à l’aide de la propriété
Utilisez le constructeur
En outre, les propriétés de la classe PrintJob permettent de lire les paramètres d’impression de l’utilisateur, tels que la hauteur de la page, la largeur et l’orientation de l’image ; vous pouvez également configurer votre document afin de formater dynamiquement le contenu Flash en fonction des réglages de l’imprimante.
Remarque : à l’inverse des versions précédentes, ActionScript 3 0 ne limite pas un objet PrintJob à une image unique. Toutefois, dans la mesure où le système d’exploitation affiche des informations sur l’état de l’impression dès que l’utilisateur clique sur le bouton OK de la boîte de dialogue d’impression, il est conseillé d’appeler
En outre, un délai d’expiration du script de 15 secondes s’applique aux intervalles suivants :
Si l’un des intervalles précédents excède 15 secondes, l’appel suivant de la méthode
Remarque : le constructeur est configuré de telle manière que l’une des trois méthodes d’impression (une feuille par page, deux feuilles par page ou impression dans la moitié supérieure de la page) peut être sélectionnée en fonction d’une préférence. Cet exemple ne s’exécutera pas correctement à moins que précisément deux des méthodes d’impression ne soient désactivées au moyen de commentaires de code. L’exemple est conçu pour que
PrintJob.addPage().
Vous pouvez, par exemple, remplacer l’espace réservé
// create PrintJob object
var myPrintJob:PrintJob = new PrintJob();
// display Print dialog box, but only initiate the print job
// if start returns successfully.
if (myPrintJob.start()) {
// add specified page to print job
// repeat once for each page to be printed
try {
myPrintJob.addPage([params]);
}
catch(e:Error) {
// handle error
}
try {
myPrintJob.addPage([params]);
}
catch(e:Error) {
// handle error
}
// send pages from the spooler to the printer, but only if one or more
// calls to addPage() was successful. You should always check for successful
// calls to start() and addPage() before calling send().
myPrintJob.send();
}
A partir de AIR 2, vous pouvez créer et utiliser plusieurs occurrences de PrintJob. Les propriétés définies pour l’occurrence de PrintJob sont conservées après l’impression. Cela vous permet de réutiliser une occurrence de PrintJob et de conserver les préférences d’impression d’un utilisateur tout en proposant des préférences d’impression pour d’autres types de contenu dans votre application. Pour le contenu dans Flash Player et dans les versions d’AIR antérieures à 2, vous ne pouvez pas créer un deuxième objet PrintJob si le premier est toujours actif. Si vous créez un deuxième objet PrintJob (en appelant
La largeur et la hauteur d’un rectangle correspondent à des valeurs de pixel. Une imprimante utilise les points en tant qu’unités de mesure. Les points ont une taille physique fixe (1/72ème de pouce), mais la taille d’un pixel à l’écran varie selon la résolution de ce dernier. De ce fait, le taux de conversion entre les pixels et les points dépend de la configuration de l’imprimante et du redimensionnement éventuel du sprite. Un sprite non mis à l’échelle d’une largeur de 72 pixels mesure un pouce (2,54 cm) de large lorsqu’il est imprimé, sachant qu’un point correspond à un pixel quelle que soit la résolution de l’écran.
Vous pouvez utiliser les équivalences suivantes pour convertir les pouces ou les centimètres en twips ou points (un twip correspond à 1/20ème de point) :
Si vous omettez le paramètre
Si vous ne souhaitez pas spécifier de valeur pour
Si
Si
Si la tâche d’impression met plus de 15 secondes à exécuter une opération
Si vous avez transmis une valeur pour le paramètre
Si vous souhaitez redimensionner un objet Sprite avant de l’imprimer, définissez ses propriétés d’échelle (voir
La fonction d’impression de Flash Player prend en charge les imprimantes PostScript et non PostScript. Les imprimantes non PostScript convertissent les vecteurs en bitmaps.
Vous pouvez appeler cette méthode à tout moment. Appelez cette méthode avant de lancer une tâche d’impression afin de définir le format de papier par défaut dans la boîte de dialogue Mise en page ou Imprimer. Appelez cette méthode lorsqu’une tâche d’impression est en cours afin de définir le format de papier d’une étendue de pages dans la tâche.
Cette méthode n’aboutit pas si l’appel à la méthode
Le paramètre
Même lorsque le paramètre
Dans l’exemple suivant, le nombre maximal et le nombre minimal de pages de la boîte de dialogue d’impression sont définis avant que l’utilisateur ne voie s’afficher la boîte de dialogue :
Remarque : si l’utilisateur annule la boîte de dialogue d’impression, les propriétés ne sont pas renseignées.
Une fois que l’utilisateur a cliqué sur OK dans la boîte de dialogue d’impression, le lecteur démarre le processus de mise en attente d’une tâche d’impression dans le système d’exploitation. Dans la mesure où le système d’exploitation commence alors à afficher des informations sur le déroulement de l’impression, il est conseillé d’appeler
Vérifiez que cette méthode renvoie la valeur
Si l’un des intervalles suivants dure plus de 15 secondes pour l’occurrence de la tâche d’impression spécifiée, le prochain appel de
Après l’appel de cette méthode, il est possible de réutiliser l’occurrence de PrintJob. Dans la mesure du possible, les paramètres d’impression de la tâche sont conservés.
Si cette propriété est définie sur
S’il est impossible de déterminer une valeur de couleur ou de nuances de gris, la valeur est
Si vous n’avez pas appelé la méthode
Pour chaque tâche d’impression que vous exécutez avec une occurrence de PrintJob, définissez cette propriété avant d’appeler la méthode
S’il est impossible de déterminer la résolution, la valeur est une valeur par défaut standard. La valeur par défaut est de 600 ppp sous Linux et de 360 ppp sous Mac OS. Sous Windows, la résolution de l’imprimante est toujours disponible ; par conséquent, aucune valeur par défaut n’est nécessaire.
Remarque : à partir d’AIR 2, définissez cette propriété avant de lancer une tâche d’impression pour définir l’orientation par défaut dans les boîtes de dialogue Mise en page et Imprimer. Définissez la propriété lorsqu’une tâche d’impression est en cours (après l’appel de la méthode
Remarque : à partir d’AIR 2, cette propriété est déconseillée. Utilisez plutôt la propriété
Remarque : à partir d’AIR 2, cette propriété est déconseillée. Utilisez plutôt la propriété
Remarque : à partir d’AIR 2, cette propriété est déconseillée. Utilisez plutôt la propriété
Remarque : à partir d’AIR 2, cette propriété est déconseillée. Utilisez plutôt la propriété
Définir la valeur de cette propriété entraîne la sélection immédiate de l’imprimante. Si le choix de l’imprimante échoue, la valeur précédente de cette propriété est rétablie. Pour déterminer si la valeur de l’imprimante a été correctement définie, lisez la valeur après avoir tenté de la définir, puis confirmez qu’elle correspond à la valeur ayant été définie.
La propriété
Le tableau suivant affiche la taille approximative pour chaque type de papier. La taille est approximative, car il existe des variations entre les pilotes d’imprimante. Par exemple, la largeur d’une feuille de papier A4 peut être de 595,0, de 595,22 ou de 595,28 points selon le pilote.