Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : AIR 30.0 et versions antérieures, Flash Player 30.0 et versions antérieures, Flash Lite 4
Flex 4.6 et versions antérieures, Flash Pro CS6 et versions antérieures
Masquer les filtres
flash.printing 

PrintJob  - AS3

Packagesx

Niveau supérieur
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Eléments du langage

Constantes globales
Fonctions globales
Opérateurs
Instructions, mots clés et directives
Types spéciaux

Annexes

Nouveautés
Erreurs de compilation
Avertissements du compilateur
Erreurs d’exécution
Migration vers ActionScript 3
Jeux de caractères pris en charge
Balises MXML uniquement
Eléments XML de mouvement
Balises Timed Text
Liste des éléments déconseillés
Constantes d’implémentation d’accessibilité
Utilisation des exemples de code ActionScript
Informations juridiques
Packageflash.printing
Classepublic class PrintJob
HéritagePrintJob Inheritance EventDispatcher Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

La classe PrintJob permet de créer un contenu et de l’imprimer sur une ou plusieurs pages. Elle vous permet d’effectuer le rendu du contenu visible, dynamique ou hors écran du point de vue de l’utilisateur, de proposer à ce dernier une boîte de dialogue d’impression unique et d’imprimer un document non mis à l’échelle dans des proportions correspondant à celles du contenu. Cette fonctionnalité est particulièrement utile pour rendre et imprimer le contenu dynamique, par exemple le contenu et le texte dynamique d’une base de données.

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é PrintJob.isSupported. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.

Utilisez le constructeur PrintJob() pour créer une tâche d’impression.

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 PrintJob.addPage() et PrintJob.send() dès que possible pour envoyer les pages au spouleur. Si l’accès à l’image contenant l’appel à PrintJob.send() est soumis à un délai, le processus d’impression est également retardé.

En outre, un délai d’expiration du script de 15 secondes s’applique aux intervalles suivants :

  • PrintJob.start() et le premier appel de PrintJob.addPage()
  • Un appel PrintJob.addPage() et le prochain appel de PrintJob.addPage()
  • Le dernier appel de PrintJob.addPage() et PrintJob.send()

Si l’un des intervalles précédents excède 15 secondes, l’appel suivant de la méthode PrintJob.start() pour l’occurrence de PrintJob renvoie false, et l’appel suivant de la méthode PrintJob.addPage() pour l’occurrence de PrintJob provoque une exception d’exécution par Flash Player ou Adobe AIR.

Consulter les exemples

Plus d’exemples



Propriétés publiques
 PropriétéDéfini par
      active : Boolean
[statique] [lecture seule] Indique si une tâche d’impression est en cours.
PrintJob
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
      copies : int
Nombre de copies des pages ajoutées ultérieurement à la tâche d’impression, que le système d’impression imprime.
PrintJob
      firstPage : int
[lecture seule] Numéro de la première page de l’étendue de pages indiquée par l’utilisateur dans la boîte de dialogue Imprimer du système d’exploitation.
PrintJob
      isColor : Boolean
[lecture seule] Indique si l’imprimante sélectionnée avec les paramètres d’impression actuels imprime en couleur (true) ou en nuances de gris (false).
PrintJob
  isSupported : Boolean
[statique] [lecture seule] Indique si la classe PrintJob est prise en charge sur la plate-forme actuelle (true) ou non (false).
PrintJob
      jobName : String
Nom ou titre de la tâche d’impression.
PrintJob
      lastPage : int
[lecture seule] Numéro de la dernière page de l’étendue de pages indiquée par l’utilisateur dans la boîte de dialogue Imprimer du système d’exploitation.
PrintJob
      maxPixelsPerInch : Number
[lecture seule] Résolution physique de l’imprimante sélectionnée, en pixels par pouce.
PrintJob
  orientation : String
Orientation de l’image à imprimer.
PrintJob
  pageHeight : int
[lecture seule] Hauteur de la zone la plus grande pouvant être centrée dans la zone imprimable réelle de la page, en points.
PrintJob
  pageWidth : int
[lecture seule] Largeur de la zone la plus grande pouvant être centrée dans la zone imprimable réelle de la page, en points.
PrintJob
      paperArea : Rectangle
[lecture seule] Limites du support d’imprimante, en points.
PrintJob
  paperHeight : int
[lecture seule] Hauteur totale du papier, en points.
PrintJob
  paperWidth : int
[lecture seule] Largeur totale du papier, en points.
PrintJob
      printableArea : Rectangle
[lecture seule] Limites de la zone imprimable du support d’imprimante, en points.
PrintJob
      printer : String
Récupère ou définit l’imprimante à utiliser pour la tâche d’impression en cours.
PrintJob
      printers : Vector.<String>
[statique] [lecture seule] Fournit une liste des imprimantes disponibles en tant que valeurs de noms de chaîne.
PrintJob
      supportsPageSetupDialog : Boolean
[statique] [lecture seule] Indique si l’environnement d’exécution de Flash prend en charge une boîte de dialogue Mise en page distincte.
PrintJob
Méthodes publiques
 MéthodeDéfini par
  
Crée un objet PrintJob permettant d’imprimer une ou plusieurs pages.
PrintJob
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.
EventDispatcher
  
addPage(sprite:Sprite, printArea:Rectangle = null, options:PrintJobOptions = null, frameNum:int = 0):void
Envoie l’objet Sprite spécifié en tant que page unique au spouleur d’impression.
PrintJob
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
  
    selectPaperSize(paperSize:String):void
Définit le format de papier.
PrintJob
  
Envoie les pages mises en file d’attente à l’imprimante après l’aboutissement de l’appel des méthodes start() ou start2() et addPage().
PrintJob
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
  
Affiche la boîte de dialogue Mise en page du système d’exploitation si l’environnement actuel le permet.
PrintJob
  
Affiche la boîte de dialogue d’impression du système d’exploitation et démarre la mise en file d’attente.
PrintJob
  
    start2(uiOptions:PrintUIOptions = null, showPrintDialog:Boolean = true):Boolean
Affiche éventuellement la boîte de dialogue Imprimer du système d’exploitation, démarre la mise en file d’attente et, le cas échéant, modifie les valeurs des propriétés en lecture seule de l’objet PrintJob.
PrintJob
  
    terminate():void
Signale que la tâche d’impression doit être fermée sans être envoyée.
PrintJob
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.
EventDispatcher
Evénements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.EventDispatcher
Détails de la propriété
    

active

propriété
active:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Indique si une tâche d’impression est en cours. Une tâche d’impression est en cours (la valeur de propriété est true) si l’une des deux conditions suivantes est remplie :

  • La boîte de dialogue Mise en page ou Imprimer est affichée.
  • La méthode start() ou start2() a été appelée avec une valeur de renvoi de true, et la méthode send() ou terminate() n’a pas été appelée.

Si cette propriété est définie sur true et que vous appelez la méthode showPageSetupDialog(), start() ou start2(), le moteur d’exécution renvoie une exception.



Implémentation
    public static function get active():Boolean

Eléments de l’API associés

    

copies

propriété 
copies:int

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Nombre de copies des pages ajoutées ultérieurement à la tâche d’impression, que le système d’impression imprime. Cette valeur correspond au nombre de copies indiqué par l’utilisateur dans la boîte de dialogue Imprimer du système d’exploitation. Si le nombre de copies n’était pas affiché dans la boîte de dialogue Imprimer ou si la boîte de dialogue n’était pas présentée à l’utilisateur, la valeur est 1 (à moins qu’elle ait été modifiée par le code de l’application).



Implémentation
    public function get copies():int
    public function set copies(value:int):void
    

firstPage

propriété 
firstPage:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Numéro de la première page de l’étendue de pages indiquée par l’utilisateur dans la boîte de dialogue Imprimer du système d’exploitation. Cette propriété est zéro si l’utilisateur sollicite l’impression de toutes les pages, si l’étendue de pages n’était pas affichée dans la boîte de dialogue Imprimer ou si cette dernière n’a pas été présentée à l’utilisateur.



Implémentation
    public function get firstPage():int
    

isColor

propriété 
isColor:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Indique si l’imprimante sélectionnée avec les paramètres d’impression actuels imprime en couleur (true) ou en nuances de gris (false).

S’il est impossible de déterminer une valeur de couleur ou de nuances de gris, la valeur est true.



Implémentation
    public function get isColor():Boolean

isSupported

propriété 
isSupported:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10.1, AIR 2

Indique si la classe PrintJob est prise en charge sur la plate-forme actuelle (true) ou non (false).



Implémentation
    public static function get isSupported():Boolean
    

jobName

propriété 
jobName:String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Nom ou titre de la tâche d’impression. En règle générale, le système d’exploitation utilise le nom de la tâche comme titre de la tâche dans la file d’impression ou comme nom par défaut d’une tâche imprimée dans un fichier.

Si vous n’avez pas appelé la méthode start() ou start2() et n’avez pas défini de valeur pour la propriété, la valeur de cette propriété est null.

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 start() ou start2().

La valeur par défaut est null.



Implémentation
    public function get jobName():String
    public function set jobName(value:String):void

Valeur émise
IllegalOperationError — Si le code tente de définir la propriété alors que la propriété active est définie sur true.
    

lastPage

propriété 
lastPage:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Numéro de la dernière page de l’étendue de pages indiquée par l’utilisateur dans la boîte de dialogue Imprimer du système d’exploitation. Cette propriété est zéro si l’utilisateur sollicite l’impression de toutes les pages, si l’étendue de pages n’était pas affichée dans la boîte de dialogue Imprimer ou si cette dernière n’a pas été présentée à l’utilisateur.



Implémentation
    public function get lastPage():int
    

maxPixelsPerInch

propriété 
maxPixelsPerInch:Number  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Résolution physique de l’imprimante sélectionnée, en pixels par pouce. Cette valeur est calculée selon les paramètres d’impression en cours, comme indiqué par le système d’exploitation.

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.



Implémentation
    public function get maxPixelsPerInch():Number

orientation

propriété 
orientation:String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 9 - read only, AIR 1.0 - read only, AIR 2 - read-write

Orientation de l’image à imprimer. Les valeurs admises sont définies comme constantes dans la classe PrintJobOrientation.

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 start() ou start2()) pour définir l’orientation de l’étendue de pages dans la tâche.



Implémentation
    public function get orientation():String
    public function set orientation(value:String):void

Eléments de l’API associés

pageHeight

propriété 
pageHeight:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9.

Hauteur de la zone la plus grande pouvant être centrée dans la zone imprimable réelle de la page, en points. Les marges éventuellement définies par l’utilisateur sont ignorées. Cette propriété n’est disponible qu’après l’exécution d’un appel de la méthode PrintJob.start().

Remarque : à partir d’AIR 2, cette propriété est déconseillée. Utilisez plutôt la propriété printableArea, qui mesure la zone imprimable en fractions de point et décrit avec précision les zones imprimables hors centre.



Implémentation
    public function get pageHeight():int

Plus d’exemples

Eléments de l’API associés

pageWidth

propriété 
pageWidth:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 9, AIR 1.0

Largeur de la zone la plus grande pouvant être centrée dans la zone imprimable réelle de la page, en points. Les marges éventuellement définies par l’utilisateur sont ignorées. Cette propriété n’est disponible qu’après l’exécution d’un appel de la méthode PrintJob.start().

Remarque : à partir d’AIR 2, cette propriété est déconseillée. Utilisez plutôt la propriété printableArea, qui mesure la zone imprimable en fractions de point et décrit avec précision les zones imprimables hors centre.



Implémentation
    public function get pageWidth():int

Plus d’exemples

Eléments de l’API associés

    

paperArea

propriété 
paperArea:Rectangle  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Limites du support d’imprimante, en points. Cette valeur utilise le même système de coordonnées que celui utilisé pour les prochains appels de addPage().



Implémentation
    public function get paperArea():Rectangle

paperHeight

propriété 
paperHeight:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9.

Hauteur totale du papier, en points. Cette propriété n’est disponible qu’après l’exécution d’un appel de la méthode PrintJob.start().

Remarque : à partir d’AIR 2, cette propriété est déconseillée. Utilisez plutôt la propriété paperArea, qui mesure les dimensions de la feuille de papier en fractions de point.



Implémentation
    public function get paperHeight():int

Eléments de l’API associés

paperWidth

propriété 
paperWidth:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9.

Largeur totale du papier, en points. Cette propriété n’est disponible qu’après l’exécution d’un appel de la méthode PrintJob.start().

Remarque : à partir d’AIR 2, cette propriété est déconseillée. Utilisez plutôt la propriété paperArea, qui mesure les dimensions de la feuille de papier en fractions de point.



Implémentation
    public function get paperWidth():int

Eléments de l’API associés

    

printableArea

propriété 
printableArea:Rectangle  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Limites de la zone imprimable du support d’imprimante, en points. Cette valeur utilise le même système de coordonnées que celui utilisé pour les prochains appels de addPage().



Implémentation
    public function get printableArea():Rectangle
    

printer

propriété 
printer:String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Récupère ou définit l’imprimante à utiliser pour la tâche d’impression en cours. La chaîne transmise à l’accesseur Set et renvoyée par l’accesseur Get doit correspondre à l’une des chaînes dans le tableau renvoyé par la méthode printers(). Pour indiquer que l’imprimante par défaut doit être utilisée, définissez la valeur sur null. Sur les systèmes d’exploitation qui ne permettent pas de déterminer l’imprimante par défaut, la valeur de cette propriété est null.

     import flash.printing.PrintJob;
     
     var myPrintJob:PrintJob = new PrintJob();
     myPrintJob.printer = "HP_LaserJet_1";
     myPrintJob.start();
     

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é printer d’une tâche d’impression active ne peut pas être modifiée. Essayez de la modifier après que l’appel de la méthode start() ou start2() a abouti et avant que l’appel de la méthode send() ou terminate() n’échoue.



Implémentation
    public function get printer():String
    public function set printer(value:String):void
    

printers

propriété 
printers:Vector.<String>  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Fournit une liste des imprimantes disponibles en tant que valeurs de noms de chaîne. La liste n’est pas calculée à l’avance. Elle est générée lors de l’appel de la fonction. Si aucune imprimante n’est disponible ou si le système ne prend pas en charge l’impression, la valeur est null(). Si le système prend en charge l’impression, mais ne parvient pas à renvoyer une liste d’imprimantes, la valeur est un vecteur avec un élément unique (sa propriété length est 1). Dans ce cas, l’unique élément correspond au nom de l’imprimante actuelle (ou au nom par défaut s’il s’avère impossible de déterminer le nom de l’imprimante actuelle).



Implémentation
    public static function get printers():Vector.<String>
    

supportsPageSetupDialog

propriété 
supportsPageSetupDialog:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Indique si l’environnement d’exécution de Flash prend en charge une boîte de dialogue Mise en page distincte. Si cette propriété est définie sur true, vous pouvez appeler la méthode showPageSetupDialog() pour afficher la boîte de dialogue Mise en page du système d’exploitation.



Implémentation
    public static function get supportsPageSetupDialog():Boolean

Eléments de l’API associés

Détails du constructeur

PrintJob

()Constructeur
public function PrintJob()

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Crée un objet PrintJob permettant d’imprimer une ou plusieurs pages. Après avoir créé un objet PrintJob, vous devez utiliser (dans l’ordre spécifié) les méthodes PrintJob.start(), PrintJob.addPage() et PrintJob.send() pour envoyer la tâche d’impression à l’imprimante.

Vous pouvez, par exemple, remplacer l’espace réservé [params] associé aux appels de la méthode myPrintJob.addPage() par des paramètres personnalisés, comme indiqué dans le code ci-dessous :

 // 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 new PrintJob()) tandis que le premier objet PrintJob est toujours actif, le deuxième objet PrintJob ne sera pas créé. Il est donc recommandé de vérifier la valeur de myPrintJob avant de créer un deuxième objet PrintJob.


Valeur émise
IllegalOperationError — Dans Flash Player et les versions d’AIR antérieures à 2, renvoie une exception si un autre objet PrintJob est encore actif.

Eléments de l’API associés

Détails de la méthode

addPage

()méthode
public function addPage(sprite:Sprite, printArea:Rectangle = null, options:PrintJobOptions = null, frameNum:int = 0):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9.

Envoie l’objet Sprite spécifié en tant que page unique au spouleur d’impression. Avant d’utiliser cette méthode, vous devez créer un objet PrintJob, puis utiliser start() ou start2() Ensuite, après avoir appelé une ou plusieurs fois addPage() pour une tâche d’impression, utilisez send() pour envoyer à l’imprimante les pages mises en file d’attente. En d’autres termes, après avoir créé un objet PrintJob, utilisez (dans l’ordre spécifié ci-après) start() ou start2(), addPage(), puis send() pour envoyer la tâche d’impression à l’imprimante. Vous pouvez appeler addPage() plusieurs fois après un unique appel à start() pour imprimer plusieurs pages d’une tâche d’impression.

Si addPage() entraîne le renvoi d’une exception par Flash Player (par exemple, si vous n’avez pas appelé start() ou si l’utilisateur a annulé la tâche d’impression), les appels suivants de addPage() échoueront. Cependant, si les appels précédents de addPage() ont abouti, la commande finale send() envoie les pages correctement mises en file d’attente vers l’imprimante.

Si la tâche d’impression met plus de 15 secondes à exécuter une opération addPage(), Flash Player renvoie une exception au prochain appel de addPage().

Si vous avez transmis une valeur pour le paramètre printArea, les coordonnées x et y du rectangle printArea établissent une correspondance avec le coin supérieur gauche (coordonnées 0, 0) de la zone imprimable sur la page. Les propriétés en lecture seule pageHeight et pageWidth décrivent la zone imprimable définie par start(). Dans la mesure où elle s’aligne sur le coin supérieur gauche de la zone imprimable sur la page, l’impression est recadrée sur la droite et/ou le bas de la zone définie par printArea si la taille de cette zone printArea est supérieure à celle de la zone imprimable sur la page. Dans Flash Professional, si vous ne transmettez aucune valeur pour le paramètre printArea et si la taille de la scène est supérieure à celle de la zone imprimable, le même type de découpage est effectué. Dans Flex ou Flash Builder, si vous ne transmettez aucune valeur pour le paramètre printArea et si la taille de l’écran est supérieure à celle de la zone imprimable, le même type de découpage est effectué.

Si vous souhaitez redimensionner un objet Sprite avant de l’imprimer, définissez ses propriétés d’échelle (voir flash.display.DisplayObject.scaleX et flash.display.DisplayObject.scaleY) avant d’appeler cette méthode, puis restaurez leur valeur d’origine après l’impression. L’échelle d’un objet Sprite ne dépend pas de printArea. Autrement dit, si vous spécifiez une zone d’impression dont la taille est 50 x 50 pixels, 2 500 pixels sont imprimés. Si vous redimensionnez l’objet Sprite, les 2 500 pixels sont imprimés, mais l’objet est imprimé à l’échelle retenue.

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.

Paramètres

sprite:Sprite — Sprite contenant le contenu à imprimer.
 
printArea:Rectangle (default = null) — Objet Rectangle qui spécifie la zone à imprimer.

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) :

  • 1 point = 1/72ème de pouce = 20 twips
  • 1 pouce = 72 points = 1 440 twips
  • 1 cm = 567 twips

Si vous omettez le paramètre printArea ou s’il est transmis de façon incorrecte, la zone entière du paramètre sprite est imprimée.

Si vous ne souhaitez pas spécifier de valeur pour printArea mais en spécifier une pour options ou frameNum, transmettez null pour printArea.

 
options:PrintJobOptions (default = null) — Paramètre facultatif qui spécifie une impression sous forme de vecteur ou de bitmap. La valeur par défaut est null, ce qui représente une demande d’impression vectorielle. Pour imprimer le sprite sous forme de bitmap, réglez la propriété printAsBitmap de l’objet PrintJobOptions sur true. Tenez compte des suggestions suivantes pour décider s’il est judicieux de régler printAsBitmap sur true :
  • Si le contenu à imprimer comprend une image bitmap, définissez printAsBitmap sur true pour inclure tout effet de transparence alpha et de couleur.
  • Si le contenu ne comporte pas d’images bitmap, omettez ce paramètre pour imprimer le contenu au format vectoriel qui est de qualité supérieure.

Si options est omis ou transmis de façon incorrecte, l’impression vectorielle s’applique. Si vous ne souhaitez pas spécifier de valeur pour options mais que vous voulez spécifier une valeur pour frameNumber, transmettez null pour options.

 
frameNum:int (default = 0) — Nombre facultatif qui permet de spécifier l’image d’un objet MovieClip devant être imprimée. La transmission de frameNum n’invoque pas ActionScript sur cette image. Si vous omettez ce paramètre et si le paramètre sprite est un objet MovieClip, l’image active du sprite est imprimée.


Valeur émise
Error — Renvoie une exception si vous n’avez pas appelé start() ou si l’utilisateur a annulé la tâche d’impression.

Plus d’exemples

Eléments de l’API associés

    selectPaperSize

()méthode 
public function selectPaperSize(paperSize:String):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Définit le format de papier. Les valeurs admises pour le paramètre paperSize sont des constantes dans la classe PaperSize. L’appel de cette méthode a une incidence sur les paramètres d’impression, comme si l’utilisateur choisissait un format de papier dans la boîte de dialogue Mise en page ou Imprimer.

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.

     import flash.printing.PrintJob;
     import flash.printing.PaperSize;
     
     var myPrintJob:PrintJob = new PrintJob();
     myPrintJob.selectPaperSize(PaperSize.ENV_10);
     

Paramètres

paperSize:String — Format de papier à utiliser pour les pages suivantes de la tâche d’impression


Valeur émise
ArgumentError — si le paramètre paperSize n’est pas l’une des valeurs admises définies dans la classe PaperSize.

Eléments de l’API associés

send

()méthode 
public function send():void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9.

Envoie les pages mises en file d’attente à l’imprimante après l’aboutissement de l’appel des méthodes start()ou start2() et addPage().

Cette méthode n’aboutit pas si l’appel à la méthode start() ou start2() échoue ou si un appel à la méthode addPage() renvoie une exception. Pour éviter une erreur, vérifiez que la méthode start() ou start2() renvoie true et repérez les exceptions de addPage() avant d’appeler cette méthode. L’exemple suivant explique comment vérifier correctement les erreurs avant d’appeler cette méthode :

     var myPrintJob:PrintJob = new PrintJob();
     if (myPrintJob.start()) {
       try {
         myPrintJob.addPage([params]);
       }
       catch(e:Error) {
          // handle error 
       }
     
       myPrintJob.send();
     }
     

Plus d’exemples

Eléments de l’API associés

    showPageSetupDialog

()méthode 
public function showPageSetupDialog():Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Affiche la boîte de dialogue Mise en page du système d’exploitation si l’environnement actuel le permet. Utilisez la propriété supportsPageSetupDialog afin de déterminer si l’affichage de la boîte de dialogue Mise en page est pris en charge.

     import flash.printing.PrintJob;
     
     var myPrintJob:PrintJob = new PrintJob();
     if (myPrintJob.supportsPageSetupDialog)
     {
         myPrintJob.showPageSetupDialog();
     }
     

Valeur renvoyée
Booleantrue si l’utilisateur choisit « OK » dans la boîte de dialogue Mise en page. Cela indique que certaines propriétés de PrintJob peuvent avoir été modifiées. Renvoie false si l’utilisateur choisit « Annuler » dans la boîte de dialogue Mise en page.

Valeur émise
IllegalOperationError — si le système ne prend pas en charge la mise en page. Utilisez la propriété supportsPageSetupDialog afin de déterminer si l’affichage de la boîte de dialogue Mise en page est pris en charge.
 
IllegalOperationError — si une tâche d’impression (notamment la tâche d’impression en cours) est active.

Eléments de l’API associés

start

()méthode 
public function start():Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9., Flash Player 9.

Affiche la boîte de dialogue d’impression du système d’exploitation et démarre la mise en file d’attente. La boîte de dialogue Imprimer permet à l’utilisateur de modifier les paramètres d’impression. Lorsque la méthode PrintJob.start() est correctement renvoyée (l’utilisateur clique sur OK dans la boîte de dialogue Imprimer), les propriétés suivantes, qui représentent les paramètres d’impression en cours de l’utilisateur, sont renseignées :

PropriétéTypeUnitsRemarques
PrintJob.paperHeightNumberPointsHauteur totale du papier.
PrintJob.paperWidthNumberPointsLargeur totale du papier.
PrintJob.pageHeightNumberPointsHauteur de la zone imprimable réelle de la page. Les marges éventuellement définies par l’utilisateur sont ignorées.
PrintJob.pageWidthNumberPointsLargeur de la zone imprimable réelle de la page. Les marges éventuellement définies par l’utilisateur sont ignorées.
PrintJob.orientationString"portrait" (flash.printing.PrintJobOrientation.PORTRAIT) ou "paysage" (flash.printing.PrintJobOrientation.LANDSCAPE).

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 PrintJob.addPage() et PrintJob.send() dès que possible pour envoyer les pages au spouleur. Vous pouvez utiliser les propriétés en lecture seule height, width et orientation qui sont renseignées par cette méthode pour mettre en forme l’impression.

Vérifiez que cette méthode renvoie la valeur true (lorsque l’utilisateur clique sur OK dans la boîte de dialogue d’impression du système d’exploitation) avant d’appeler à nouveau PrintJob.addPage() et PrintJob.send() :

     var myPrintJob:PrintJob = new PrintJob();
        if(myPrintJob.start()) {
          // addPage() and send() statements here
        }
     

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 PrintJob.start() renvoie false :

  • PrintJob.start() et le premier appel de PrintJob.addPage()
  • Un appel de PrintJob.addPage() et le prochain appel de PrintJob.addPage()
  • Le dernier appel de PrintJob.addPage() et PrintJob.send()

Valeur renvoyée
Boolean — Renvoie true si l’utilisateur clique sur OK lorsque la boîte de dialogue d’impression s’affiche, false s’il clique sur Annuler ou si une erreur se produit.

Valeur émise
IllegalOperationError — Dans AIR 2 ou les versions ultérieures, indique si une autre tâche d’impression est actuellement en cours.

Plus d’exemples

Eléments de l’API associés

    start2

()méthode 
public function start2(uiOptions:PrintUIOptions = null, showPrintDialog:Boolean = true):Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Affiche éventuellement la boîte de dialogue Imprimer du système d’exploitation, démarre la mise en file d’attente et, le cas échéant, modifie les valeurs des propriétés en lecture seule de l’objet PrintJob.

Le paramètre uiOptions permet à l’appelant de contrôler les options qui s’affichent dans la boîte de dialogue Imprimer. Voir la classe PrintUIOptions. Ce paramètre est ignoré si showPrintDialog est false.

Même lorsque le paramètre showPrintDialogest défini sur true, le comportement de cette méthode peut différer de celui de la méthode start(). Sur certains systèmes d’exploitation, start() affiche la boîte de dialogue Mise en page, suivie de la boîte de dialogue Imprimer. En revanche, start2() n’affiche jamais la boîte de dialogue Mise en page.

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 :

     import flash.printing.PrintJob;
     import flash.printing.PrintUIOptions;
     
     var myPrintJob:PrintJob = new PrintJob();
     var uiOpt:PrintUIOptions = new PrintUIOptions();
     uiOpt.minPage = 1;
     uiOpt.maxPage = 3;
     var accepted:Boolean = myPrintJob.start2(uiOpt);
     

Paramètres

uiOptions:PrintUIOptions (default = null) — Objet désignant les options affichées dans la boîte de dialogue Imprimer que l’utilisateur voit s’afficher. Si le paramètre showPrintDialog est défini sur false, cette valeur est ignorée.
 
showPrintDialog:Boolean (default = true) — Indique si la boîte de dialogue d’impression s’affiche à l’utilisateur avant de lancer la tâche d’impression.

Valeur renvoyée
Boolean — La valeur true si l’utilisateur clique sur OK lorsque la boîte de dialogue Imprimer s’affiche, ou si elle n’apparaît pas et qu’aucune erreur n’est renvoyée ; false si l’utilisateur clique sur Annuler ou si une erreur se produit.

Valeur émise
IllegalOperationError — Si la boîte de dialogue Mise en page s’affiche ou si une autre tâche d’impression est actuellement active.

Eléments de l’API associés

    terminate

()méthode 
public function terminate():void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Signale que la tâche d’impression doit être fermée sans être envoyée. Utilisez cette méthode lorsqu’une tâche d’impression a déjà été lancée par un appel de la méthode start() ou start2(), mais qu’il n’est pas opportun d’envoyer les pages à l’imprimante. En règle générale, la méthode terminate() est utilisée uniquement pour purger les erreurs.

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.

PrintJobExample_Simple.as

L’exemple suivant explique les principes de base de l’impression. Un nouvel objet PrintJob est créé et, si elle est lancée correctement, la méthode addPage() ajoute le sprite en tant que page unique. La méthode send() met la page en file d’attente dans l’imprimante.
package 
{ 
    import flash.printing.PrintJob; 
    import flash.display.Sprite; 
 
    public class BasicPrintExample extends Sprite 
    { 
        var myPrintJob:PrintJob = new PrintJob(); 
        var mySprite:Sprite = new Sprite();
        mySprite.graphics.beginFill(0x336699);
    mySprite.graphics.drawCircle(100, 100, 50);
 
        public function BasicPrintExample() 
        { 
            if (myPrintJob.start()) {
            try {
                myPrintJob.addPage(mySprite);
            }
            catch(e:Error) {
                // handle error 
            }
            myPrintJob.send();
        } 
    } 
}
PrintJobExample.as

L’exemple suivant utilise la classe PrintJobExample pour créer un petit document qui est ensuite envoyé à l’imprimante. Pour ce faire, exécutez la procédure suivante :
  1. Deux variables de type Sprite, nommées sheet1 et sheet2, sont déclarées.
  2. init() est appelé pour attribuer une nouvelle occurrence de Sprite à sheet1 et sheet2, et pour appeler ensuite createSheet() au moyen de différents arguments.
  3. createSheet() produit le résultat suivant :
    1. L’objet Sprite transmis est utilisé pour dessiner un rectangle d’une largeur de 100 pixels pour une hauteur de 200 pixels (x = 0 et y = 0), avec un arrière-plan de couleur gris clair et une bordure noire d’un pixel d’épaisseur.
    2. Un nouvel objet TextField, nommé txt, est créé en utilisant les dimensions du Sprite ; la propriété wordWrap est définie sur true et la propriété text est définie sur le Sprite transmis comme argument à createSheet().
    3. Si la valeur de l’argument Object transmis n’est pas null, créez une nouvelle occurrence du Sprite nommée img et utilisée pour dessiner un rectangle blanc à l’aide des propriétés de dimension et de coordonnée de l’objet transmis. Le rectangle blanc est ajouté à la liste d’affichage de l’objet Sprite par le biais de addChild().
    4. L’objet TextField txt est ajouté à la liste d’affichage de l’objet Sprite au moyen de addChild().
  4. Au niveau du constructeur, la méthode d’impression qui est activée (pas commentée) est appelée. En raison de la similitude des méthodes, seule printOnePerPage() est décrite ci-dessous.
  5. printOnePerPage() produit le résultat suivant :
    1. Déclaration d’un nouvel objet PrintJob, nommé pj, et de pagesToPrint en tant que uint.
    2. Ouverture de la boîte de dialogue d’impression native du système d’exploitation et attente que l’utilisateur clique sur OK.
    3. Vérification de l’orientation et si l’option Paysage est sélectionnée, renvoi d’une erreur et fermeture.
    4. Définition de la hauteur et de la largeur de la page pour sheet1 et sheet2.
    5. Envoi de sheet1 et sheet2 au spouleur d’impression par le biais de addPage().
    6. Si le nombre de pages à imprimer est > 0, impression de toutes les pages spoulées.
  6. La méthode draw() est appelée, redimensionnement des deux propriétés Sprite pour les intégrer à la scène avec un repositionnement de sheet2 pour qu’elle se situe juste à droite de sheet1.

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 printOnePerPage() soit appelée.

package {
    import flash.printing.PrintJob;
    import flash.printing.PrintJobOrientation;
    import flash.display.Stage;
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.geom.Rectangle;
       
    public class PrintJobExample extends Sprite {
        private var sheet1:Sprite;
        private var sheet2:Sprite;
           
        public function PrintJobExample() {
            init();
            printOnePerPage();
//            printTwoPerPage();
//            printTopHalf();
            draw();
        }
        
        private function init():void {
            sheet1 = new Sprite();
            createSheet(sheet1, "Once upon a time...", {x:10, y:50, width:80, height:130});

            sheet2 = new Sprite();
            createSheet(sheet2, "There was a great story to tell, and it ended quickly.\n\nThe end.", null);
        }
        
        private function createSheet(sheet:Sprite, str:String, imgValue:Object):void {
            sheet.graphics.beginFill(0xEEEEEE);
            sheet.graphics.lineStyle(1, 0x000000);
            sheet.graphics.drawRect(0, 0, 100, 200);
            sheet.graphics.endFill();
            
            var txt:TextField = new TextField();
            txt.height = 200;
            txt.width = 100;
            txt.wordWrap = true;
            txt.text = str;
            
            if(imgValue != null) {
                var img:Sprite = new Sprite();
                img.graphics.beginFill(0xFFFFFF);
                img.graphics.drawRect(imgValue.x, imgValue.y, imgValue.width, imgValue.height);
                img.graphics.endFill();
                sheet.addChild(img);
            }
            sheet.addChild(txt);
        }
        
        private function printOnePerPage():void {
            var pj:PrintJob = new PrintJob();
            var pagesToPrint:uint = 0;
            if(pj.start()) {                
                if(pj.orientation == PrintJobOrientation.LANDSCAPE) {    
                    throw new Error("Without embedding fonts you must print one sheet per page with an orientation of portrait.");
                }
                
                sheet1.height = pj.pageHeight;
                sheet1.width = pj.pageWidth;
                sheet2.height = pj.pageHeight;
                sheet2.width = pj.pageWidth;

                try {
                    pj.addPage(sheet1);
                    pagesToPrint++;
                }
                catch(e:Error) {
                    // do nothing
                }

                try {
                    pj.addPage(sheet2);
                    pagesToPrint++;
                }
                catch(e:Error) {
                    // do nothing
                }

                if(pagesToPrint > 0) {
                    pj.send();
                }
            }
        }
        
        private function printTwoPerPage():void {
            var pj:PrintJob = new PrintJob();
            var pagesToPrint:uint = 0;
            if(pj.start()) {                
                if(pj.orientation == PrintJobOrientation.PORTRAIT) {
                    throw new Error("Without embedding fonts you must print two sheets per page with an orientation of landscape.");
                }
                
                sheet1.height = pj.pageHeight;
                sheet1.width = pj.pageWidth/2;
                sheet2.height = pj.pageHeight;
                sheet2.width = pj.pageWidth/2;

                var sheets:Sprite = new Sprite();
                sheets.addChild(sheet1);
                sheets.addChild(sheet2);
                sheets.getChildAt(1).x = sheets.getChildAt(0).width;
                try {
                    pj.addPage(sheets);
                    pagesToPrint++;
                }
                catch(e:Error) {
                    // do nothing
                }

                if(pagesToPrint > 0) {
                    pj.send();
                }
            }
        }

        private function printTopHalf():void {
            var pj:PrintJob = new PrintJob();
            var pagesToPrint:uint = 0;
            if(pj.start()) {                
                if(pj.orientation == PrintJobOrientation.PORTRAIT) {
                    throw new Error("Without embedding fonts you must print the top half with an orientation of landscape.");
                }
                
                sheet1.height = pj.pageHeight;
                sheet1.width = pj.pageWidth/2;
                sheet2.height = pj.pageHeight;
                sheet2.width = pj.pageWidth/2;

                var sheets:Sprite = new Sprite();
                sheets.addChild(sheet1);
                sheets.addChild(sheet2);
                sheets.getChildAt(1).x = sheets.getChildAt(0).width;
                try {
                    pj.addPage(sheets, new Rectangle(0, 0, sheets.width, sheets.height/2));
                    pagesToPrint++;
                }
                catch(e:Error) {
                    // do nothing
                }

                if(pagesToPrint > 0) {
                    pj.send();
                }
            }
        }


        private function draw():void {
            var sheetWidth:Number = this.stage.stageWidth/2;
            var sheetHeight:Number = this.stage.stageHeight;
            
            addChild(sheet1);
            sheet1.width = sheetWidth;
            sheet1.height = sheetHeight;
            
            addChild(sheet2);
            sheet2.width = sheetWidth;
            sheet2.height = sheetHeight;
            sheet2.x = sheet1.width;
        }        
    }
}
PrintJobExample.2.as

L’exemple suivant décrit des fonctions d’impression supplémentaires. Cet exemple initialise les paramètres de PrintJob correspondant au nombre de copies, au format de papier (Légal US) et à l’orientation de la page (Paysage). Il impose tout d’abord l’affichage de la boîte de dialogue Mise en page, puis lance la tâche d’impression en affichant la boîte de dialogue Imprimer.
 
package 
 { 
     import flash.display.Sprite; 
     import flash.display.Stage; 
     import flash.geom.Rectangle; 
     import flash.printing.PaperSize; 
     import flash.printing.PrintJob; 
    import flash.printing.PrintJobOrientation; 
    import flash.printing.PrintUIOptions; 
    import flash.text.TextField; 
      
     public class PrintJobExample extends Sprite 
     { 
         private var bg:Sprite; 
         private var txt:TextField; 
        private var pj:PrintJob; 
        private var uiOpt:PrintUIOptions; 
  
         public function PrintJobExample():void 
         { 
            var pj = new PrintJob(); 
            uiOpt = new PrintUIOptions(); 
            initPrintJob(); 
             initContent(); 
             draw(); 
             printPage(); 
         } 
          
         private function printPage():void 
         { 
            if (pj.supportsPageSetupDialog) 
            { 
                pj.showPageSetupDialog(); 
            }
            
             if (pj.start2(uiOpt, true)) 
             { 
                   try 
                 { 
                     pj.addPage(this, new Rectangle(0, 0, 100, 100)); 
                 } 
                 catch (error:Error) 
                 { 
                     // Do nothing. 
                 } 
                 pj.send(); 
             } 
             else 
             { 
                 txt.text = "Print job terminated"; 
                pj.terminate(); 
             } 
         } 
         
         private function initContent():void 
         { 
             bg = new Sprite(); 
             bg.graphics.beginFill(0x00FF00); 
             bg.graphics.drawRect(0, 0, 100, 200); 
             bg.graphics.endFill(); 
              
             txt = new TextField(); 
             txt.border = true; 
             txt.text = "Hello World"; 
         } 
          
        private function initPrintJob():void 
        { 
            pj.setPaperSize(PaperSize.LEGAL); 
            pj.orientation = PrintJobOrientation.LANDSCAPE; 
            pj.copies = 2; 
            pj.jobName = "Flash test print";
        } 
         
         private function draw():void 
         { 
             addChild(bg); 
             addChild(txt); 
             txt.x = 50; 
             txt.y = 50; 
         } 
     } 
}




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.