Drukowanie strony

Flash Player 9 i nowsze wersje, Adobe AIR 1.0 i nowsze wersje

Do realizacji drukowania można użyć instancji klasy PrintJob. Aby wydrukować prostą stronę za pośrednictwem programu Flash Player lub AIR, należy użyć kolejno czterech instrukcji:

  • new PrintJob() : tworzy nową instancję zadania drukowania o podanej nazwie.

  • PrintJob.start() : rozpoczyna proces drukowania w systemie operacyjnym, wywołując okno dialogowe drukowania widoczne dla użytkownika i przypisując wartości właściwościom zadania drukowania, które są przeznaczone tylko do odczytu.

  • PrintJob.addPage() : określa szczegóły zawartości zadania drukowania, w tym obiekt Sprite (i wszelkie zawarte w nim obiekty podrzędne), rozmiar obszaru wydruku oraz opcję drukowania wektorowego lub bitmapowego. Kolejne wywołania addPage() umożliwiają wydrukowanie wielu ikonek na kilku kolejnych stronach.

  • PrintJob.send() : wysyła strony do drukarki zdefiniowanej w systemie operacyjnym.

Oto przykładowy prosty skrypt zadania drukowania (zawierający instrukcje package , import i class potrzebne do kompilacji):

package 
{ 
    import flash.printing.PrintJob; 
    import flash.display.Sprite; 
 
    public class BasicPrintExample extends Sprite 
    { 
        var myPrintJob:PrintJob = new PrintJob(); 
        var mySprite:Sprite = new Sprite(); 
 
        public function BasicPrintExample() 
        { 
            myPrintJob.start(); 
            myPrintJob.addPage(mySprite); 
            myPrintJob.send(); 
        } 
    } 
}
Uwaga: Ten przykład ilustruje tylko podstawowe elementy skryptu drukującego i zawiera żadnych mechanizmów obsługi błędów. Aby napisać skrypt, który będzie prawidłowo reagował na anulowanie zadania drukowania, należy zapoznać się z sekcją Praca z wyjątkami i powrotami .

Jeśli z jakiegoś powodu konieczne jest wyczyszczenie właściwości obiektu PrintJob, należy przypisać zmiennej PrintJob wartość null (np. myPrintJob = null ).