ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.printing 

PrintJobOptions  - AS3

Paketflash.printing
Klassepublic class PrintJobOptions
VererbungPrintJobOptions Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Die PrintJobOptions-Klasse enthält Eigenschaften, die mit dem options-Parameter der PrintJob.addPage()-Methode verwendet werden. Weitere Informationen zu addPage() finden Sie im Abschnitt zur PrintJob-Klasse.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
      pixelsPerInch : Number = NaN
Legt die Auflösung für Bitmaps in Pixel pro Zoll fest.
PrintJobOptions
  printAsBitmap : Boolean = false
Gibt an, ob der Inhalt des Druckauftrags als Bitmap oder Vektorgrafik gedruckt wird.
PrintJobOptions
      printMethod : String
Gibt an, dass die Flash-Laufzeitumgebung die am besten geeignete Druckmethode wählt, oder dass der Autor ausdrücklich Vektor- oder Bitmapdruck auswählen möchte.
PrintJobOptions
Öffentliche Methoden
 MethodeDefiniert von
  
PrintJobOptions(printAsBitmap:Boolean = false)
Erstellt ein neues PrintJobOptions-Objekt.
PrintJobOptions
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails
    

pixelsPerInch

Eigenschaft
public var pixelsPerInch:Number = NaN

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2

Legt die Auflösung für Bitmaps in Pixel pro Zoll fest. Der Standardwert ist Number.NaN und gibt an, dass die native Druckerauflösung verwendet wird.

Die Einstellung für die Auflösung gilt sowohl für Bitmap- als auch für Vektordruck. Beim Bitmapdruck steuert die Auflösung die Rasterung der gesamten Seite. Beim Vektordruck steuert die Auflösung, wie bestimmte Inhalte, zum Beispiel Bitmaps und Farbverläufe, gerastert werden.

printAsBitmap

Eigenschaft 
public var printAsBitmap:Boolean = false

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Gibt an, ob der Inhalt des Druckauftrags als Bitmap oder Vektorgrafik gedruckt wird. Der Standardwert ist false, d. h. Drucken im Vektorformat.

Wenn der zu druckende Inhalt ein Bitmapbild enthält, setzen Sie die printAsBitmap-Eigenschaft auf true, um Alphatransparenz und Farbeffekte einzuschließen. Drucken Sie den Inhalt im Vektorformat (höhere Qualität, Standardeinstellung), wenn keine Bitmapbilder vorhanden sind.

Verwenden Sie die folgende Syntax, wenn Sie Inhalt beispielsweise als Bitmap drucken möchten:

         var options:PrintJobOptions = new PrintJobOptions();
         options.printAsBitmap = true;
         myPrintJob.addPage(mySprite, null, options);
         

Hinweis: Adobe AIR unterstützt das Drucken im Vektorformat unter Mac OS nicht.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Im folgenden Beispiel wird zuerst ein Bild geladen und in einen rechteckigen Rahmen gesetzt, danach wird das Bild als Bitmap gedruckt.
  1. Der Konstruktor lädt das Bild (image.jpg) mithilfe der Loader- und URLRequest-Objekte. Es wird auch überprüft, ob beim Laden ein Fehler aufgetreten ist. Hier wird davon ausgegangen, dass sich die Datei im selben Verzeichnis wie die SWF-Datei befindet. Bei der Kompilierung der SWF-Datei muss „Sicherheit bei lokaler Wiedergabe“ auf „Nur auf lokale Dateien zugreifen“ eingestellt sein.
  2. Nachdem das Bild geladen wurde (das Ereignis ist abgeschlossen), wird die completeHandler()-Methode aufgerufen.
  3. Die completeHandler()-Methode erstellt ein BitmapData-Objekt und lädt das Bild (Bitmap) in dieses Objekt. Ein Rechteck wird im Sprite-Objekt (frame) gezeichnet, und mit der beginBitmapFill()-Methode wird das Rechteck mit dem Bild (ein BitmapData-Objekt) gefüllt. Ein Matrix-Objekt wird verwendet, um das Bild auf die Größe des Rechtecks zu skalieren. (Beachten Sie, dass das Bild dadurch verzerrt wird. Es wird in diesem Beispiel verwendet, um sicherzustellen, dass das Bild in das Rechteck passt.) Nachdem das Bild das Rechteck ausfüllt, wird die printPage()-Methode aufgerufen.
  4. Die printPage()-Methode erstellt eine neue Instanz des Druckauftrags und startet den Druckvorgang, wodurch das Druckdialogfeld für den Benutzer aufgerufen wird, und füllt die Eigenschaften des Druckauftrags. Die addPage()-Methode enthält die Details des Druckauftrags. Hier ist der Rahmen mit dem Bild (ein Sprite-Objekt) für den Druck als Bitmap und nicht als Vektor eingerichtet. options ist eine Instanz der PrintJobOptions-Klasse, und seine Eigenschaft printAsBitmap ist auf true eingestellt, damit das Bild als Bitmap gedruckt wird (die Standardeinstellung ist „false“).

Hinweis: Für dieses Beispiel wurde nur eine sehr eingeschränkte Fehlerverarbeitung definiert.

package {
    import flash.display.Sprite;
    import flash.display.Loader;
    import flash.display.Bitmap;
    import flash.display.BitmapData;    
    import flash.printing.PrintJob;
    import flash.printing.PrintJobOptions;
    import flash.events.Event;
    import flash.events.IOErrorEvent;
    import flash.net.URLRequest;
    import flash.geom.Matrix;

    public class printAsBitmapExample extends Sprite {

        private var frame:Sprite = new Sprite();
        private var url:String = "image.jpg";
        private var loader:Loader = new Loader();

        public function printAsBitmapExample() {

           var request:URLRequest = new URLRequest(url);
  
           loader.load(request);
           loader.contentLoaderInfo.addEventListener(Event.COMPLETE, completeHandler);
           loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        }

        private function completeHandler(event:Event):void {
        
            var picture:Bitmap = Bitmap(loader.content);
            var bitmap:BitmapData = picture.bitmapData;

            var matrix:Matrix = new Matrix();

            matrix.scale((200 / bitmap.width), (200 / bitmap.height));
            
            frame.graphics.lineStyle(10);
            frame.graphics.beginBitmapFill(bitmap, matrix, true);
            frame.graphics.drawRect(0, 0, 200, 200);
            frame.graphics.endFill();

            addChild(frame);
             
            printPage();    
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("Unable to load the image: " + url);
        }

        private function printPage ():void {
            var myPrintJob:PrintJob = new PrintJob();
            var options:PrintJobOptions = new PrintJobOptions();
            options.printAsBitmap = true;
            
            myPrintJob.start();
  
            try {
                myPrintJob.addPage(frame, null, options);
            }
            catch(e:Error) {
                trace ("Had problem adding the page to print job: " + e);
            }
 
            try {
            myPrintJob.send();
            }
            catch (e:Error) {
                trace ("Had problem printing: " + e);    
            }
        }
    }
}

    

printMethod

Eigenschaft 
printMethod:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2

Gibt an, dass die Flash-Laufzeitumgebung die am besten geeignete Druckmethode wählt, oder dass der Autor ausdrücklich Vektor- oder Bitmapdruck auswählen möchte.

Setzen Sie die Eigenschaft auf einen der folgenden in der PrintMethod-Klasse definierten Werte:

  • PrintMethod.AUTO: Gibt an, dass Vektor- oder Bitmapdruck basierend auf dem zu druckenden Inhalt automatisch gewählt wird. Vektordruck wird verwendet, wenn der Inhalt zuverlässig mit dieser Methode gedruckt werden kann. Wenn Transparenz oder bestimmte andere Effekte vorhanden sind, wird stattdessen Bitmapdruck verwendet.
  • PrintMethod.VECTOR: Legt den Vektordruck fest. Diese Einstellung entspricht dem Einstellen von printAsBitmap auf false.
  • PrintMethod.BITMAP: Legt den Bitmapdruck fest. Identisch mit dem Einstellen von printAsBitmap auf true.

Wenn printMethod auf einen dieser unterstützten Werte gesetzt ist, wird printAsBitmap ignoriert.

Der Standardwert ist null; die printAsBitmap-Eigenschaft wird verwendet.



Implementierung
    public function get printMethod():String
    public function set printMethod(value:String):void

Auslöser
ArgumentError — Die angegebene printMethod ist keiner der in der PrintMethod-Klasse angegebenen Werte.

Verwandte API-Elemente

Konstruktordetails

PrintJobOptions

()Konstruktor
public function PrintJobOptions(printAsBitmap:Boolean = false)

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Erstellt ein neues PrintJobOptions-Objekt. Übergeben Sie dieses Objekt an den options-Parameter der PrintJob.addPage()-Methode.

Parameter
printAsBitmap:Boolean (default = false) — Beim Wert true wird dieses Objekt als Bitmap gedruckt. Beim false wird dieses Objekt als Vektor gedruckt.

Wenn der zu druckende Inhalt ein Bitmapbild enthält, setzen Sie die printAsBitmap-Eigenschaft auf true, um Alphatransparenz und Farbeffekte einzuschließen. Verwenden Sie diesen Parameter nicht, wenn der Inhalt keine Bitmapbilder enthält. Dadurch wird der Inhalt im Vektorformat mit einer höheren Qualität gedruckt (dies ist die Standardeinstellung).

Hinweis: Adobe AIR unterstützt das Drucken im Vektorformat unter Mac OS nicht.

Verwandte API-Elemente





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.