Pakiet | flash.printing |
Klasa | public class PrintJobOptions |
Dziedziczenie | PrintJobOptions Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
options
metody PrintJob.addPage()
. Więcej informacji o metodzie addPage()
zawiera opis klasy PrintJob.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
pixelsPerInch : Number = NaN
Określa rozdzielczość, jaka ma być używana dla bitmap, w pikselach na cal. | PrintJobOptions | ||
printAsBitmap : Boolean = false
Określa, czy treść zadania wydruku ma być drukowana jako bitmapa, czy jako obiekt wektorowy. | PrintJobOptions | ||
printMethod : String
Określa, że środowisko wykonawcze Flash wybiera najbardziej odpowiednią metodę drukowania lub autor chce jawnie wybrać drukowanie wektorowe albo drukowanie bitmapy. | PrintJobOptions |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
PrintJobOptions(printAsBitmap:Boolean = false)
Tworzy nowy obiekt PrintJobOptions. | PrintJobOptions | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
pixelsPerInch | właściwość |
public var pixelsPerInch:Number = NaN
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2 |
Określa rozdzielczość, jaka ma być używana dla bitmap, w pikselach na cal. Wartość domyślna Number.NaN
oznacza, że jest używana rodzima rozdzielczość drukarki.
Ustawienie rozdzielczości dotyczy drukowania bitmapy i drukowania wektorowego. W przypadku drukowania bitmap rozdzielczość wpływa na sposób rasteryzacji całej strony. W przypadku drukowania obrazów wektorowych rozdzielczość wpływa na sposób rasteryzacji konkretnych elementów treści, takich jak bitmapy i gradienty.
printAsBitmap | właściwość |
public var printAsBitmap:Boolean = false
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Określa, czy treść zadania wydruku ma być drukowana jako bitmapa, czy jako obiekt wektorowy. Wartością domyślną jest false
dla drukowania w postaci wektorowej.
Jeśli drukowana zawartość obejmuje bitmapę, dla printAsBitmap
należy ustawić true
w celu uwzględnienia dowolnej przezroczystości alpha i efektów kolorów. Jeśli zawartość nie obejmuje obrazów bitmap, należy wydrukować zawartość w formacie wektorowym o wyższej jakości (opcja domyślna).
Na przykład: w celu wydrukowania zawartości w postaci bitmapy należy zastosować składnię:
var options:PrintJobOptions = new PrintJobOptions(); options.printAsBitmap = true; myPrintJob.addPage(mySprite, null, options);
Uwaga: środowisko Adobe AIR nie obsługuje drukowania wektorowego w systemie Mac OS.
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
- Konstruktor ładuje zdjęcie (
image.jpg
) za pomocą obiektówLoader
iURLRequest
. Sprawdza również, czy podczas ładowania nie wystąpiły błędy. W niniejszym przykładzie założono, że plik znajduje się w tym samym katalogu, co plik SWF. Plik SWF należy skompilować z opcją Zabezpieczenie odtwarzania lokalnego ustawioną na wartość Tylko pliki dostępne lokalnie. - Po załadowaniu zdjęcia (zakończeniu zdarzenia) następuje wywołanie metody
completeHandler()
. - Metoda
completeHandler()
tworzy obiektBitmapData
, a następnie ładuje do niego zdjęcie (bitmapę). W obiekcieSprite
zostanie narysowany prostokąt (wartośćframe
), a metodabeginBitmapFill()
zostanie użyta w celu wypełniania prostokąta zdjęciem (obiektBitmapData
). ObiektMatrix
jest używany również w celu wyskalowania obrazu i dopasowania go do prostokąta. (Należy zauważyć, że spowoduje to zniekształcenie obrazu. Obiekt został zastosowany w tym przykładzie w celu zapewnienia, że obraz będzie pasował). Po wypełnieniu obrazu następuje wywołanie metodyprintPage()
. - Metoda
printPage()
tworzy nową instancję zadania drukowania i uruchamia proces drukowania, który wywołuje okno dialogowe drukowania dla użytkownika, a następnie wprowadza wartości dla właściwości zadania drukowania. MetodaaddPage()
zawiera dane szczegółowe dotyczące zadania drukowania. W tym miejscu klatka ze zdjęciem (obiekt Sprite) zostaje ustawiona w taki sposób, że jest drukowana jako bitmapa a nie jako wektor.options
to instancja klasyPrintJobOptions
, a jej właściwośćprintAsBitmap
jest ustawiona na wartośćtrue
w celu drukowania jako bitmapa (ustawieniem domyślnym jest wartość false).
Uwaga: W tym przykładzie zdefiniowano bardzo ograniczoną obsługę błędów.
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 | właściwość |
printMethod:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2 |
Określa, że środowisko wykonawcze Flash wybiera najbardziej odpowiednią metodę drukowania lub że autor chce jawnie wybrać drukowanie wektorowe lub drukowanie bitmapy.
Ustaw właściwość na jedną z następujących wartości zdefiniowanych w klasie PrintMethod
:
PrintMethod.AUTO
: Określa, że drukowanie wektorowe lub drukowanie bitmapy jest wybierane automatycznie na podstawie treści przeznaczonej do drukowania. Drukowanie wektorowe będzie używane za każdym razem, gdy treść może zostać wiernie odtworzona przez tę metodę. Jeśli dostępny jest efekt przezroczystości lub inne efekty, będzie stosowana metoda drukowania bitmapy.PrintMethod.VECTOR
: Określa drukowanie wektorowe. Tak samo, jak ustawieniefalse
dlaprintAsBitmap
.PrintMethod.BITMAP
: Określa drukowanie bitmapy. Tak samo, jak ustawienietrue
dlaprintAsBitmap
.
Jeśli metoda printMethod jest ustawiona na jedną z obsługiwanych wartości, wówczas printAsBitmap jest ignorowane.
Wartością domyślną jest null
; używana jest właściwość printAsBitmap.
Implementacja
public function get printMethod():String
public function set printMethod(value:String):void
Zgłasza
ArgumentError — Określona metoda printMethod nie jest jedną z wartości, które definiuje klasa PrintMethod .
|
Powiązane elementy interfejsu API
PrintJobOptions | () | Konstruktor |
public function PrintJobOptions(printAsBitmap:Boolean = false)
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Tworzy nowy obiekt PrintJobOptions. Ten obiekt należy przekazać do parametru options
metody PrintJob.addPage()
.
printAsBitmap:Boolean (default = false ) — W przyupadku wartości true ten obiekt jest drukowany jako bitmapa. W przypadku wartości false ten obiekt jest drukowany jako wektor.
Jeśli drukowana zawartość obejmuje bitmapę, dla Uwaga: Środowisko Adobe AIR nie obsługuje drukowania wektorowego w systemie Mac OS. |
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z