Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: AIR 30.0 или более ранней версии, Flash Player 30.0 или более ранней версии, Flash Lite 4
Flex 4.6 или более ранней версии, Flash Pro CS6 или более ранней версии
Скрыть фильтры
flash.printing 

PrintJob  - AS3

Пакетыx

Верхний уровень
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

Элементы языка

Глобальные константы
Глобальные функции
Операторы
Инструкции, ключевые слова и директивы
Специальные типы

Приложения

Новые возможности
Ошибки компилятора
Предупреждения компилятора
Ошибки времени выполнения
Миграция ActionScript 3
Поддерживаемые наборы символов
Только MXML
Элементы движения XML
Теги Timed Text
устаревший_индекс
Константы реализации специальных возможностей
Использование примеров
Юридическая информация
Пакетflash.printing
Классpublic class PrintJob
НаследованиеPrintJob Inheritance EventDispatcher Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Класс PrintJob позволяет создавать содержимое и распечатывать его на одной или нескольких страницах. Этот класс позволяет прорисовывать для пользователя содержимое, которое является видимым, отображается динамически или находится вне экрана, открывать для пользователей одно диалоговое окно «Печать» и печатать немасштабированный документ с пропорциями, соответствующими пропорциям содержимого. Эта возможность особенно полезна для прорисовки и печати динамического содержимого, например содержимого баз данных и динамического текста.

Поддержка в мобильных браузерах: этот класс не поддерживается в мобильных браузерах.

Поддержка в профилях AIR: эта функция поддерживается во всех компьютерных операционных системах, но не поддерживается на мобильных устройствах или в среде AIR для телевизионных устройств. Используйте свойство PrintJob.isSupported, чтобы проверить наличие поддержки в среде выполнения. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».

Используйте конструктор PrintJob() для создания задания печати.

Кроме того, благодаря свойствам класса PrintJob можно считывать параметры настройки принтера, например высоту страницы, ее ширину и ориентацию изображения, и настроить в документе динамическое форматирование содержимого Flash в соответствии с параметрами принтера.

Примечание. ActionScript 3.0 не ограничивает объект PrintJob одним кадром (как это было в предыдущих версиях программы ActionScript). Однако, поскольку операционная система отображает информацию о состоянии печати пользователю, после того как он нажал кнопку «ОК» в диалоговом окне «Печать», необходимо как можно быстрее вызвать методы PrintJob.addPage() и PrintJob.send(), чтобы отправить страницы в диспетчер очереди печати. Задержка при обращении к кадру, содержащему вызов PrintJob.send(), приводит к задержке процесса печати.

Кроме того, для следующих интервалов применяется 15 секундное ограничение задержки сценария:

  • между PrintJob.start() и первымPrintJob.addPage()
  • между PrintJob.addPage() и следующим PrintJob.addPage()
  • между последним PrintJob.addPage() и PrintJob.send()

Если любой из вышеуказанных интервалов длится более 15 секунд, следующий вызов метода PrintJob.start() для экземпляра PrintJob возвращает значение false, а следующее обращение к методу PrintJob.addPage() для этого экземпляра PrintJob вызывает в приложении Flash Player или Adobe AIR исключение при выполнении.

Посмотреть примеры



Общедоступные свойства
 СвойствоОпределено
      active : Boolean
[статические] [только для чтения] Указывает, активно ли в данный момент задание печати.
PrintJob
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
      copies : int
Число экземпляров, которое система печати печатает для всех страниц, впоследствии добавляемых в задание печати.
PrintJob
      firstPage : int
[только для чтения] Номер первой страницы диапазона, введенный пользователем в системном диалоговом окне «Печать».
PrintJob
      isColor : Boolean
[только для чтения] Указывает, какой режим использует выбранный принтер с текущими настройками печати: цветной (true) или градации серого (false).
PrintJob
  isSupported : Boolean
[статические] [только для чтения] Указывает, поддерживает ли текущая платформа класс PrintJob: да (true) или нет (false).
PrintJob
      jobName : String
Имя или заголовок задания печати.
PrintJob
      lastPage : int
[только для чтения] Номер последней страницы диапазона, введенный пользователем в системном диалоговом окне «Печать».
PrintJob
      maxPixelsPerInch : Number
[только для чтения] Физическое разрешение выбранного принтера, в пикселах на дюйм.
PrintJob
  orientation : String
Ориентация изображения при печати.
PrintJob
  pageHeight : int
[только для чтения] Высота самой большой области, которую можно расположить по центру фактической области печати на странице (в пунктах).
PrintJob
  pageWidth : int
[только для чтения] Ширина самой большой области, которую можно расположить по центру фактической области печати на странице (в пунктах).
PrintJob
      paperArea : Rectangle
[только для чтения] Границы материала для печати в принтере, в пунктах.
PrintJob
  paperHeight : int
[только для чтения] Общая высота бумаги (в пунктах).
PrintJob
  paperWidth : int
[только для чтения] Общая ширина бумаги (в пунктах).
PrintJob
      printableArea : Rectangle
[только для чтения] Границы области печати материала в принтере, в пунктах.
PrintJob
      printer : String
Получает или задает принтер для выполнения текущего задания печати.
PrintJob
      printers : Vector.<String>
[статические] [только для чтения] Предоставляет список доступных принтеров в виде строковых значений имен.
PrintJob
      supportsPageSetupDialog : Boolean
[статические] [только для чтения] Указывает, поддерживает ли текущая среда выполнения Flash отображение отдельного диалогового окна «Параметры страницы».
PrintJob
Общедоступные методы
 МетодОпределено
  
Создает объект PrintJob, который можно использовать для печати одной или нескольких страниц.
PrintJob
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
  
addPage(sprite:Sprite, printArea:Rectangle = null, options:PrintJobOptions = null, frameNum:int = 0):void
Отправляет заданный объект Sprite в диспетчер очереди печати принтера в виде одной страницы.
PrintJob
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
  
    selectPaperSize(paperSize:String):void
Установите формат бумаги.
PrintJob
  
Отправляет на принтер страницы, переданные в диспетчер печати, после успешных вызовов методов start() или start2() и addPage().
PrintJob
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
Отображает диалоговое окно «Параметры страницы» операционной системы, если это поддерживается текущая среда.
PrintJob
  
Выводит на экран системное диалоговое окно «Печать» и начинает передачу задания диспетчеру печати.
PrintJob
  
    start2(uiOptions:PrintUIOptions = null, showPrintDialog:Boolean = true):Boolean
По выбору может открывать диалоговое окно «Печать» операционной системы, запускать подкачку и при возможности изменять доступные только для чтения значения свойств PrintJob.
PrintJob
  
    terminate():void
Сообщает, что задание печати необходимо прервать без отправки.
PrintJob
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
Сведения о свойстве
    

active

свойство
active:Boolean  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Указывает, активно ли в данный момент задание печати. Задание печати является активным (свойство имеет значение true) в любом из двух случаев.

  • В данный момент отображается диалоговое окно «Параметры страницы» или «Печать».
  • Метод start() или start2() вызывался и возвратил значение true, и не вызывался метод send() или terminate().

Если это свойство имеет значение true и вызывается метод showPageSetupDialog(), start() или start2(), среда выполнения выдает исключение.



Реализация
    public static function get active():Boolean

Связанные элементы API

    

copies

свойство 
copies:int

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Число экземпляров, которое система печати печатает для всех страниц, впоследствии добавляемых в задание печати. Это значение указывает число экземпляров, введенное пользователем в диалоговом окне «Печать» операционной системы. Если в диалоговом окне «Печать» не отображается число экземпляров или если это окно не выводится, используется значение 1 (если оно не изменено кодом приложения).



Реализация
    public function get copies():int
    public function set copies(value:int):void
    

firstPage

свойство 
firstPage:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Номер первой страницы диапазона, введенный пользователем в системном диалоговом окне «Печать». Это свойство имеет нулевое значение, если пользователь запрашивает печать всех страниц, если диапазон страниц не отображался в диалоговом окне «Печать» или если это окно не выводилось.



Реализация
    public function get firstPage():int
    

isColor

свойство 
isColor:Boolean  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Указывает, какой режим использует выбранный принтер с текущими настройками печати: цветной (true) или градации серого (false).

Если не удается определить режим, используется значение true.



Реализация
    public function get isColor():Boolean

isSupported

свойство 
isSupported:Boolean  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.1, AIR 2

Указывает, поддерживает ли текущая платформа класс PrintJob: да (true) или нет (false).



Реализация
    public static function get isSupported():Boolean
    

jobName

свойство 
jobName:String

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Имя или заголовок задания печати. Имя задания обычно используется операционной системой как заголовок задания в очереди печати или как имя по умолчанию для задания, которое печатается в файл.

Если еще не вызывался метод start() или start2() и свойство не задано, то ему задается значение null.

Для каждого задания печати, выполняемого с помощью экземпляра PrintJob, задайте это свойство до вызова метода start() или start2().

Значением по умолчанию является null.



Реализация
    public function get jobName():String
    public function set jobName(value:String):void

Выдает
IllegalOperationError — если код пытается установить свойство, когда свойство active имеет значение true.
    

lastPage

свойство 
lastPage:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Номер последней страницы диапазона, введенный пользователем в системном диалоговом окне «Печать». Это свойство имеет нулевое значение, если пользователь запрашивает печать всех страниц, если диапазон страниц не отображался в диалоговом окне «Печать» или если это окно не выводилось.



Реализация
    public function get lastPage():int
    

maxPixelsPerInch

свойство 
maxPixelsPerInch:Number  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Физическое разрешение выбранного принтера, в пикселах на дюйм. Это значение вычисляется в соответствии с текущими настройками печати в операционной системе.

Если определить разрешение не удается, используется значение по умолчанию. Значение по умолчанию — 600 пикс./дюйм в ОС Linux и 360 пикс./дюйм в ОС Mac OS. В ОС Windows разрешение принтера всегда доступно, поэтому значение по умолчанию не требуется.



Реализация
    public function get maxPixelsPerInch():Number

orientation

свойство 
orientation:String

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 9 - read only, AIR 1.0 - read only, AIR 2 - read-write

Ориентация изображения при печати. Допустимые значения определены как константы в классе PrintJobOrientation.

Примечание. В AIR 2 и более поздних версиях это свойство можно установить до начала печати, чтобы задать ориентацию по умолчанию в диалоговых окнах «Параметры страницы» и «Печать». Установите это свойство в процессе выполнения задания печати (после вызова метода start() или start2(), чтобы задать ориентацию для диапазона страниц в текущем задании.



Реализация
    public function get orientation():String
    public function set orientation(value:String):void

Связанные элементы API

pageHeight

свойство 
pageHeight:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.

Высота самой большой области, которую можно расположить по центру фактической области печати на странице (в пунктах). Любые границы, установленные пользователем, игнорируются. Это свойство доступно только после того, как был вызван метод PrintJob.start().

Примечание. В AIR 2 и более поздних версиях это свойство игнорируется. Используйте вместо него свойство printableArea, которое измеряет область печати в дробных пунктах и точно описывает области печати, смещенные относительно центра.



Реализация
    public function get pageHeight():int

Связанные элементы API

pageWidth

свойство 
pageWidth:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 9, AIR 1.0

Ширина самой большой области, которую можно расположить по центру фактической области печати на странице (в пунктах). Любые границы, установленные пользователем, игнорируются. Это свойство доступно только после того, как был вызван метод PrintJob.start().

Примечание. В AIR 2 и более поздних версиях это свойство игнорируется. Используйте вместо него свойство printableArea, которое измеряет область печати в дробных пунктах и точно описывает области печати, смещенные относительно центра.



Реализация
    public function get pageWidth():int

Связанные элементы API

    

paperArea

свойство 
paperArea:Rectangle  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Границы материала для печати в принтере, в пунктах. Это значение использует ту же систему координат, что и в последующих вызовах метода addPage().



Реализация
    public function get paperArea():Rectangle

paperHeight

свойство 
paperHeight:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.

Общая высота бумаги (в пунктах). Это свойство доступно только после того, как был вызван метод PrintJob.start().

Примечание. В AIR 2 и более поздних версиях это свойство игнорируется. Вместо него используйте свойство paperArea, которое измеряет размеры бумаги в дробных пунктах.



Реализация
    public function get paperHeight():int

Связанные элементы API

paperWidth

свойство 
paperWidth:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.

Общая ширина бумаги (в пунктах). Это свойство доступно только после того, как был вызван метод PrintJob.start().

Примечание. В AIR 2 и более поздних версиях это свойство игнорируется. Вместо него используйте свойство paperArea, которое измеряет размеры бумаги в дробных пунктах.



Реализация
    public function get paperWidth():int

Связанные элементы API

    

printableArea

свойство 
printableArea:Rectangle  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Границы области печати материала в принтере, в пунктах. Это значение использует ту же систему координат, что и в последующих вызовах метода addPage().



Реализация
    public function get printableArea():Rectangle
    

printer

свойство 
printer:String

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Получает или задает принтер для выполнения текущего задания печати. Объект String, передаваемый установщику получателем, должен соответствовать одной из строк в объекте Array, возращенном методом printers(). Чтобы указать, что необходимо использовать принтер по умолчанию, задайте этому свойству значение null. В операционных системах, где невозможно определить принтер по умолчанию, это свойство имеет значение null.

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

Когда задается значение для этого свойства, предпринимается попытка немедленно выбрать принтер. Если выбрать принтер не удается, используется предыдущее значение этого свойства. Чтобы узнать, удалось ли задать значение принтера, проверьте значение свойства после попытки установить его и убедитесь, соответствует ли оно заданному значению.

Свойство printer активного задания печати изменить нельзя. Попытки изменить свойство после успешного вызова метода start() или start2() и перед вызовом метода send() или terminate() не дают результатов.



Реализация
    public function get printer():String
    public function set printer(value:String):void
    

printers

свойство 
printers:Vector.<String>  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Предоставляет список доступных принтеров в виде строковых значений имен. Список не вычисляется предварительно, он генерируется в момент вызова функции. Если нет доступных принтеров или система не поддерживает печать, используется значение null. Если система поддерживает печать, но не может вернуть список принтеров, в качестве значения используется объект Vector с одним элементом (его свойство length имеет значение 1). В этом случае единственный элемент содержит действительное имя принтера, либо имя по умолчанию, если невозможно определить имя текущего принтера.



Реализация
    public static function get printers():Vector.<String>
    

supportsPageSetupDialog

свойство 
supportsPageSetupDialog:Boolean  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Указывает, поддерживает ли текущая среда выполнения Flash отображение отдельного диалогового окна «Параметры страницы». Если это свойство имеет значение true, можно вызвать метод showPageSetupDialog(), чтобы вывести системное диалоговое окно «Параметры страницы».



Реализация
    public static function get supportsPageSetupDialog():Boolean

Связанные элементы API

Сведения о конструкторе

PrintJob

()Конструктор
public function PrintJob()

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Создает объект PrintJob, который можно использовать для печати одной или нескольких страниц. После создания объекта PrintJob для отправки задания печати на принтер необходимо использовать (в указанном порядке) методы PrintJob.start(), PrintJob.addPage(), а затем PrintJob.send().

Например, можно заменить текст-заполнитель [params] для вызовов метода myPrintJob.addPage() пользовательскими параметрами, как показано в следующем коде.

 // 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();
 }
 

В AIR 2 и более поздних версиях можно создавать и использовать несколько экземпляров PrintJob. Свойства, заданные для экземпляра PrintJob, сохраняются после завершения печати. Это позволяет многократно использовать экземпляр PrintJob и сохранять выбранные пользователем установки печати, предлагая другие настройки для остального содержимого в приложении. Для содержимого во Flash Player и в AIR до версии 2 нельзя создавать второй объект PrintJob, пока активен первый. Если второй объект PrintJob создается (вызовом метода new PrintJob()), когда активен первый объект PrintJob, второй объект создан не будет. Поэтому можно проверить значение myPrintJob, прежде чем создавать второй объект PrintJob.


Выдает
IllegalOperationError — Во Flash Player и AIR до версии AIR 2 выдается исключение, если еще активен другой экземпляр PrintJob.

Связанные элементы API

Сведения о методе

addPage

()метод
public function addPage(sprite:Sprite, printArea:Rectangle = null, options:PrintJobOptions = null, frameNum:int = 0):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.

Отправляет заданный объект Sprite в диспетчер очереди печати принтера в виде одной страницы. Перед использованием этого метода необходимо создать объект PrintJob, а затем применить метод start() или start2(). Затем, после вызова метода addPage() один или несколько раз для задания печати, используйте метод send() для передачи страниц в диспетчере очереди печати на принтер. Другими словами, после создания объекта PrintJob для отправки задания печати на принтер необходимо использовать (в указанном порядке) методы start(), addPage(), а затем send(). Метод addPage() можно вызывать несколько раз после вызова метода start(), чтобы напечатать несколько страниц в задании печати.

Если метод addPage() вызывает исключение в проигрывателе Flash Player (например, если не вызван метод start() или пользователь отменил задание печати), любой последующий вызов addPage() завершится ошибкой. Однако, если предыдущие вызовы метода addPage() были успешными, завершающая команда send() отправляет на принтер страницы, успешно помещенные в очередь диспетчера печати.

Если заданию печати требуется более 15 секунд для выполнения операции addPage(), то проигрыватель Flash Player вызовет исключение при следующем вызове метода addPage().

Если передается значение для параметра printArea, то в качестве координат x и y прямоугольника printArea задается верхний левый угол (координаты 0,0) области печати страницы. Предназначенные только для чтения свойства pageHeight и pageWidth описывают область печати, заданную методом start(). Поскольку печатаемые данные выравниваются по верхнему левому углу области печати страницы, то когда область, определенная параметром printArea больше, чем область печати страницы, печатаемые данные обрезаются по правой или по левой границе (или по обеим сразу) области, заданной параметром printArea. Если во Flash Professional значение для параметра printArea не передано и рабочая область больше области печати, выполняется обрезка по такому же принципу. Если во Flex или Flash Builder значение параметра printArea не передано и размеры экрана превышают размеры области печати, выполняется обрезка по такому же принципу.

Если требуется отмасштабировать объект Sprite перед тем как распечатывать его, установите свойства масштабирования (см. flash.display.DisplayObject.scaleX и flash.display.DisplayObject.scaleY) прежде чем вызывать этот метод, а затем верните их в исходное состояние после выполнения печати. Масштаб объекта Sprite не связан с параметром printArea. Таким образом, если указывается область печати 50 x 50 пикселей, распечатывается 2500 пикселей. Если объект Sprite масштабируется, распечатываются те же 2500 пикселей, но объект Sprite при этом печатается в отмасштабированном размере.

Функция печати в проигрывателе Flash Player может работать с поддерживающими и не поддерживающими PostScript принтерами. В принтерах, которые не поддерживают PostScript, происходит преобразование векторных изображений в растровые.

Параметры

sprite:Sprite — Объект Sprite с содержимым для печати.
 
printArea:Rectangle (default = null) — Прямоугольный объект, указывающий область для печати.

Значения ширины и высоты прямоугольника задаются в пикселях. Принтер использует точки в качестве единиц измерения для печати. Точки имеют фиксированный физический размер (1/72 дюйма), но размер пикселя на экране зависит от разрешения конкретного экрана. Поэтому коэффициент преобразования между пикселями и точками зависит от параметров принтера и масштабирования объекта Sprite. Немасштабированный объект Sprite, имеющий ширину 72 пиксела, печатается с шириной 1 дюйм, при этом одна точка будет равна одному пикселу, независимо от разрешения экрана.

Можно использовать следующие соответствия для преобразования дюймов или сантиметров в твипы или точки (твип равен 1/20 части точки):

  • 1 точка = 1/72 дюйма = 20 твипов
  • 1 дюйм = 72 пунктам = 1440 твипам
  • 1 см = 567 твипам

Если параметр printArea пропущен или неверно передан, распечатывается вся область параметра sprite.

Если не требуется указывать значение для параметра printArea, но необходимо значение для параметров options или frameNum, укажите null в качестве значения для printArea.

 
options:PrintJobOptions (default = null) — Дополнительный параметр, который указывает на необходимость выполнять печать в векторном или растровом формате. По умолчанию установлено значение null, которое соответствует запросу на печать в векторном формате. Чтобы распечатать объект sprite в растровом формате, установите для свойства printAsBitmap объекта rintJobOptions значение true. Не забывайте о следующих рекомендациях, когда определяете, устанавливать ли для свойства printAsBitmap значение true.
  • Если распечатываемое содержимое содержит растровое изображение, установите для свойства printAsBitmap значение true, чтобы можно было включить альфа-прозрачность и какие-либо цветовые эффекты.
  • Если в содержимом нет растровых изображений, пропустите данный параметр, чтобы распечатать содержимое в высококачественном векторном формате.

Если параметр options пропущен или передан неверно, используется векторная печать. Если не требуется указывать значение для параметра options, но необходимо значение для параметра frameNum, укажите null в качестве значения для options.

 
frameNum:int (default = 0) — Необязательный объект Number, который позволяет указать, какой кадр объекта MovieClip необходимо напечатать. Передача свойства frameNum не позволяет вызвать код ActionScript для этого кадра. Если этот параметр пропущен, а параметр sprite содержит объект MovieClip, печатается текущий кадр в sprite.


Выдает
Error — Выдается исключение, если не был вызван метод start() или пользователь отменяет задание печати

Связанные элементы API

    selectPaperSize

()метод 
public function selectPaperSize(paperSize:String):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Установите формат бумаги. Допустимые значения для параметра paperSize перечислены в качестве констант в классе PaperSize. Вызов этого метода изменяет настройки печати так же, как пользователь задает размер бумаги в диалоговых окнах «Параметры страницы» или «Печать».

Этот метод можно вызвать в любое время. Вызовите этот метод до запуска задания, чтобы задать формат бумаги по умолчанию в диалоговых окнах «Параметры страницы» или «Печать». Вызовите его в процессе выполнения задания печати, чтобы задать формат бумаги для диапазона страниц в этом задании.

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

Параметры

paperSize:String — Формат бумаги, который должен использоваться для последующих страниц задания печати.


Выдает
ArgumentError — если параметру paperSize задано значение, не определенное в классе PaperSize.

Связанные элементы API

send

()метод 
public function send():void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.

Отправляет на принтер страницы, переданные в диспетчер печати, после успешных вызовов методов start() или start2() и addPage().

Этот метод не удается выполнить, если операция start() или start2() завершается ошибкой или если вызов метода addPage() выдает исключение. Чтобы избежать ошибки, перед вызовом этого метода убедитесь, что метод start() или start2() возвращает true, и обработайте все исключения addPage(). В следующем примере показано, как правильно проверять наличие ошибок перед вызовом этого метода.

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

Связанные элементы API

    showPageSetupDialog

()метод 
public function showPageSetupDialog():Boolean

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Отображает диалоговое окно «Параметры страницы» операционной системы, если это поддерживается текущая среда. Используйте свойство supportsPageSetupDialog, чтобы определить, поддерживается ли отображение окна «Параметры страницы».

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

Возвращает
Boolean — Возвращает значение true, если пользователь нажимает кнопку «ОК» в диалоговом окне «Параметры страницы». Это обозначает, что некоторые свойства PrintJob, могли измениться. Возвращает значение false, если пользователь нажимает кнопку «Отмена» в диалоговом окне «Параметры страницы».

Выдает
IllegalOperationError — если система не поддерживает вызов диалогового окна «Параметры страницы». Используйте свойство supportsPageSetupDialog, чтобы определить, поддерживается ли отображение окна «Параметры страницы».
 
IllegalOperationError — если активно какое-либо задание печати (включая текущее).

Связанные элементы API

start

()метод 
public function start():Boolean

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9., Flash Player 9.

Выводит на экран системное диалоговое окно «Печать» и начинает передачу задания диспетчеру печати. Диалоговое окно «Печать» позволяет пользователю изменять параметры печати. Если метод PrintJob.start() успешно выполняется (пользователь нажимает кнопку «ОК» в диалоговом окне «Печать»), то следующие свойства заполняются значениями, соответствующими параметрам печати, установленным пользователем.

СвойствоТипЕдиницыПримечания
PrintJob.paperHeightNumberПунктыОбщая высота страницы.
PrintJob.paperWidthNumberПунктыОбщая ширина страницы.
PrintJob.pageHeightNumberПунктыВысота фактически печатаемой области на странице; все установленные пользователем границы игнорируются.
PrintJob.pageWidthNumberПунктыШирина фактически печатаемой области на странице; любые установленные пользователем границы игнорируются.
PrintJob.orientationStringportrait (flash.printing.PrintJobOrientation.PORTRAIT) или landscape (flash.printing.PrintJobOrientation.LANDSCAPE).

Примечание. Если пользователь закрывает диалоговое окно «Печать», эти свойства не заполняются.

После того как пользователь нажмет кнопку «ОК» в диалоговом окне «Печать», проигрыватель начинает отправлять задание печати в очередь диспетчера печати операционной системы. Поскольку операционная система затем начинает отображать пользователю информацию о выполнении печати, необходимо как можно быстрее вызвать методы PrintJob.addPage() и PrintJob.send(), чтобы отправить страницы в диспетчер очереди печати. Можно использовать доступные только для чтения свойства высоты, ширины и ориентации страницы, которые этот метод подставляет при форматировании печатаемой страницы.

Проверьте, возвращает ли метод значение true (если пользователь нажмет кнопку «ОК» в диалоговом окне «Печать» операционной системы) перед последующим вызовом одного из методов PrintJob.addPage() и PrintJob.send():

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

Для заданного экземпляра задания печати, если какой-либо из следующих интервалов длится дольше 15 секунд, при следующем вызове PrintJob.start() будет возвращаться значение false:

  • между PrintJob.start() и первымPrintJob.addPage()
  • между PrintJob.addPage() и следующим PrintJob.addPage()
  • между последним PrintJob.addPage() и PrintJob.send()

Возвращает
Boolean — Устанавливается значение true, если пользователь нажал кнопку «ОК», когда открылось диалоговое окно «Печать»; а значение false, если была нажата кнопка «Отмена».

Выдает
IllegalOperationError — в AIR 2 или более поздних версиях, если в данный момент активен другой экземпляр PrintJob.

Связанные элементы API

    start2

()метод 
public function start2(uiOptions:PrintUIOptions = null, showPrintDialog:Boolean = true):Boolean

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

По выбору может открывать диалоговое окно «Печать» операционной системы, запускать подкачку и при возможности изменять доступные только для чтения значения свойств PrintJob.

Параметр uiOptions позволяет вызывающему объекту определять, какие параметры должны отображаться в диалоговом окне «Печать». См. описание класса PrintUIOptions. Этот параметр игнорируется, если свойство showPrintDialog имеет значение false.

Даже когда свойство showPrintDialog имеет значение true, поведение этого метода может отличаться от поведения исходного метода start(). В некоторых операционных системах метод start() сначала показывает диалоговое окно «Параметры страницы», а затем окно «Печать». Метод start2(), напротив, никогда не показывает диалоговое окно «Параметры страницы».

В следующем примере перед выводом диалогового окна «Печать» для пользователя задаются параметры минимального и максимального номеров страниц.

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

Параметры

uiOptions:PrintUIOptions (default = null) — Объект, который определяет параметры, отображаемые в диалоговом окне «Печать» для пользователя. Если параметр showPrintDialog имеет значение false, это значение игнорируется.
 
showPrintDialog:Boolean (default = true) — Определяет, показывается ли пользователю диалоговое окно «Печать» перед запуском задания печати.

Возвращает
Boolean — Имеет значение true, если пользователь нажимает кнопку «ОК» при появлении диалогового окна «Печать» или если это окно не появляется и не возникает ошибки; имеет значение false, если пользователь нажимает кнопку «Отмена» или если возникает ошибка.

Выдает
IllegalOperationError — Если в данный момент отображается окно «Параметры печати» или активно другое задание печати.

Связанные элементы API

    terminate

()метод 
public function terminate():void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2

Сообщает, что задание печати необходимо прервать без отправки. Используйте этот метод, когда задание печати уже инициировано вызовом start() или start2(), но в данный момент неуместно отправлять страницы принтеру. Как правило, метод terminate() используется только для исправления ошибок.

После вызова этого метода экземпляр PrintJob можно использовать повторно. Настройки печати для задания по возможности сохраняются для последующего использования.

PrintJobExample_Simple.as

Следующий пример демонстрирует основы печати. Создается новый объект PrintJob, и в случае успешного вызова метод addPage() добавляет спрайт как одну страницу. Метод send() передает страницу принтеру.
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

В следующем примере класс PrintJobExample используется для создания небольшого документа и последующей отправки его на принтер. Это можно сделать, выполнив следующие действия:
  1. Объявляются две переменные типа Sprite с названиями sheet1 и sheet2.
  2. Вызывается метод init(), который назначает новый экземпляр Sprite обеим переменным sheet1 и sheet2, а затем вызывается метод createSheet().
  3. Метод createSheet() выполняет следующие действия:
    1. Передаваемый объект Sprite используется для создания прямоугольника со светло-серой заливкой, черной рамкой толщиной в один пиксель, шириной в 100 пикселей и высотой в 200 пикселей, с координатами x = 0, y = 0.
    2. Создается новый объект TextField с именем txt и такими же размерами, что и объект Sprite, для свойства wordWrap устанавливается значение true, а для текстового свойства в качестве аргумента для createSheet() устанавливается «Строка передана».
    3. Если определено значение для переданного аргумента объекта, создайте новый экземпляр Sprite с именем img, который используется для отображения белого прямоугольника, используя свойства координат и размеров переданного объекта. Этот белый прямоугольник добавляется к списку отображения объекта Sprite с помощью метода addChild().
    4. Объект TextField с названием txt добавляется к списку отображения объекта Sprite с помощью метода addChild().
  4. Выполняется обратный переход в конструктор, а затем вызывается разрешенный (незакомментированный) метод печати. Поскольку методы очень похожи, далее описан только один из них printOnePerPage().
  5. Метод printOnePerPage() выполняет следующие действия:
    1. Объявляется новый объект PrintJob с именем pj и pagesToPrint в качестве объекта uint.
    2. Открывается предусмотренное в операционной системе диалоговое окно «Печать», выполняется ожидание, пока пользователь не нажмет кнопку «OK».
    3. Проверяется ориентация, и если выбрана альбомная ориентация, выдается сообщение об ошибке и выполнение операции завершается.
    4. Настраивается высота и ширина страницы для sheet1 и sheet2.
    5. Объекты sheet1 и sheet2 отправляются в диспетчер очереди печати принтера с помощью метода addPage().
    6. Если число страниц для печати больше нуля, выполняется печать всех помещенных в очередь печати страниц.
  6. Метод draw() вызывается, когда необходимо изменить размеры двух объектов Sprite для размещения на монтажном столе или изменения положения sheet2, например, поместив его справа от sheet1.

Примечание. Конструктор настроен таким образом, что можно выбрать один из трех методов печати (печать одной страницы на лист, двух страниц на лист или печать в верхней половине листа) в зависимости от предпочтения. Этот пример не будет работать правильно до тех пор, пока два метода печати не будут отключены с помощью комментариев в программном коде. Пример настроен таким образом, что будет вызываться метод printOnePerPage().

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

Следующий пример демонстрирует дополнительные функции печати. В примере инициализируются настройки PrintJob для числа экземпляров, размера бумаги (legal) и ориентации страницы (альбомная). Сначала вызывается диалоговое окно «Параметры страницы», затем запускается задание печати путем вызова диалогового окне «Печать».
 
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 ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.