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

См. также

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

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

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

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

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

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

Нельзя создать второй объект PrintJob, если уже есть один такой активный объект. Если второй объект PrintJob создается (вызовом метода new PrintJob()), когда активен первый объект PrintJob, второй объект создан не будет. Поэтому можно проверить значение my_pj, прежде чем создавать второй объект PrintJob.

См. также

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

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

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

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

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

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

Параметры

См. также

Отправляет страницы в очереди печати на принтер после успешного выполнения методов PrintJob.start() и PrintJob.addPage(). Невозможны успешные вызовы метода PrintJob.send(), если вызов PrintJob.start() завершился с ошибкой или возникло исключение при вызове PrintJob.addpage(). Необходимо проверить, что при вызове метода PrintJob.start() возвращается значение true и перехватить любое исключение PrintJob.addpage(), прежде чем вызывать метод PrintJob.send(). Например,

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

См. также

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

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

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

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

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

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

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

См. также

1. Объявляются две переменные типа Sprite с названиями sheet1 и sheet2.
2. Вызывается метод init(), который назначает новый экземпляр Sprite обеим переменным sheet1 и sheet2, а затем вызывается метод createSheet().
3. Метод createSheet() выполняет следующие действия:
4. Выполняется обратный переход в конструктор, а затем вызывается разрешенный (незакомментированный) метод печати. Поскольку методы очень похожи, далее описан только один из них printOnePerPage().
5. Метод printOnePerPage() выполняет следующие действия:
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;
        }        
    }
}