Paket | flash.printing |
Klasse | public class PrintJobOptions |
Vererbung | PrintJobOptions Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
options
-Parameter der PrintJob.addPage()
-Methode verwendet werden. Weitere Informationen zu addPage()
finden Sie im Abschnitt zur PrintJob-Klasse.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : 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 |
Methode | Definiert von | ||
---|---|---|---|
PrintJobOptions(printAsBitmap:Boolean = false)
Erstellt ein neues PrintJobOptions-Objekt. | PrintJobOptions | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
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 )
- Der Konstruktor lädt das Bild (
image.jpg
) mithilfe derLoader
- undURLRequest
-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. - Nachdem das Bild geladen wurde (das Ereignis ist abgeschlossen), wird die
completeHandler()
-Methode aufgerufen. - Die
completeHandler()
-Methode erstellt einBitmapData
-Objekt und lädt das Bild (Bitmap) in dieses Objekt. Ein Rechteck wird imSprite
-Objekt (frame
) gezeichnet, und mit derbeginBitmapFill()
-Methode wird das Rechteck mit dem Bild (einBitmapData
-Objekt) gefüllt. EinMatrix
-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 dieprintPage()
-Methode aufgerufen. - 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. DieaddPage()
-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 derPrintJobOptions
-Klasse, und seine EigenschaftprintAsBitmap
ist auftrue
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 vonprintAsBitmap
auffalse
.PrintMethod.BITMAP
: Legt den Bitmapdruck fest. Identisch mit dem Einstellen vonprintAsBitmap
auftrue
.
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
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.
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 Hinweis: Adobe AIR unterstützt das Drucken im Vektorformat unter Mac OS nicht. |
Verwandte API-Elemente
Tue Jun 12 2018, 10:04 AM Z