Der folgenden Code verwendet zum Beispiel eine PrintUIOptions-Instanz, um die minimale und maximale Seitenzahl anzugeben, wenn das Dialogfeld „Seite einrichten“ angezeigt wird:
Diese Konstante wird mit der Eigenschaft
Diese Konstante wird mit der Eigenschaft
Diese Konstante wird mit der Eigenschaft
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.
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.
Wenn der zu druckende Inhalt ein Bitmapbild enthält, setzen Sie die
Verwenden Sie die folgende Syntax, wenn Sie Inhalt beispielsweise als Bitmap drucken möchten:
Hinweis: Adobe AIR unterstützt das Drucken im Vektorformat unter Mac OS nicht.
Hinweis: Für dieses Beispiel wurde nur eine sehr eingeschränkte Fehlerverarbeitung definiert.
Setzen Sie die Eigenschaft auf einen der folgenden in der
Wenn printMethod auf einen dieser unterstützten Werte gesetzt ist, wird printAsBitmap ignoriert.
Der Standardwert ist
Unterstützung für mobile Browser: Diese Klasse wird in mobilen Browsern nicht unterstützt.
Unterstützung von AIR-Profilen: Diese Funktion wird auf allen Desktopbetriebssystemen unterstützt, jedoch nicht auf mobilen Geräten oder Geräten mit AIR für TV. Mit der
Über den
Mit den Eigenschaften der PrintJob-Klasse können Sie außerdem die Druckereinstellungen des Benutzers lesen, beispielsweise Höhe und Breite der Seite oder Bildausrichtung. Darüber hinaus können Sie das Dokument so konfigurieren, dass Flash-Inhalte dynamisch formatiert werden, die für die Druckereinstellungen geeignet sind.
Hinweis: In ActionScript 3.0 ist ein PrintJob-Objekt nicht auf ein Bild beschränkt (wie dies in früheren Versionen von ActionScript der Fall war). Da im Betriebssystem jedoch Informationen zum Druckstatus angezeigt werden, nachdem der Benutzer im Druckdialogfeld auf die Schaltfläche „OK“ geklickt hat, sollten Sie möglichst bald
Darüber hinaus gilt ein Skriptzeitlimit von 15 Sekunden für die folgenden Intervalle:
Wenn bei diesen Intervallen das Limit von 15 Sekunden überschritten wird, wird beim darauf folgenden Aufruf von
Hinweis: Der Konstruktor bietet drei Druckmethoden zur Auswahl an: ein Blatt pro Seite, zwei Blätter pro Seite oder Drucken auf die obere Hälfte der Seite. Dieses Beispiel kann nur korrekt ausgeführt werden, wenn zwei der Druckmethoden mithilfe von Code-Kommentaren deaktiviert wurden. Das Beispiel wurde so eingerichtet, dass
PrintJob.addPage().
Sie können beispielsweise den Text für den Platzhalter
// create PrintJob object
var myPrintJob:PrintJob = new PrintJob();
// display Print dialog box, but only initiate the print job
// if start returns successfully.
if (myPrintJob.start()) {
// add specified page to print job
// repeat once for each page to be printed
try {
myPrintJob.addPage([params]);
}
catch(e:Error) {
// handle error
}
try {
myPrintJob.addPage([params]);
}
catch(e:Error) {
// handle error
}
// send pages from the spooler to the printer, but only if one or more
// calls to addPage() was successful. You should always check for successful
// calls to start() and addPage() before calling send().
myPrintJob.send();
}
In AIR 2 oder höher können Sie mehrere PrintJob-Instanzen erstellen und verwenden. Die für die PrintJob-Instanz festgelegten Eigenschaften bleiben auch nach Abschluss des Druckvorgangs erhalten. Auf diese Weise können Sie eine PrintJob-Instanz wiederverwenden und die vom Benutzer ausgewählten Druckeinstellungen beibehalten, während für andere Inhalte in Ihrer Anwendung andere Druckeinstellungen angeboten werden können. Für Inhalte in Flash Player und in AIR-Versionen vor AIR 2 können Sie kein zweites PrintJob-Objekt erstellen, während das erste noch aktiv ist. Wenn Sie (durch Aufrufen von
Die Breite und Höhe eines Rechtecks werden in Pixeln angegeben. Bei Druckern wird die Druckmaßeinheit „Punkt“ verwendet. „Punkt“ ist eine feste Größe (1/72 Zoll), die Größe eines Pixels richtet sich jedoch nach der jeweiligen Auflösung des Bildschirms. Der Umrechnungsfaktor zwischen Pixel und Punkt hängt daher von den Druckereinstellungen und davon ab, ob der Sprite skaliert ist. Ein nicht skalierter Sprite mit einer Breite von 72 Pixel wird mit einer Breite von 1 Zoll gedruckt. Dabei entspricht ein Punkt einem Pixel, unabhängig von der Bildschirmauflösung.
Mit folgenden Gleichungen können Sie Zoll- oder Zentimeterangaben in Twips oder Punkt umrechnen (ein Twip ist 1/20 Punkt):
Wenn Sie den Parameter
Wenn Sie keinen Wert für
Wenn Sie
Wenn durch
Wenn der
Wenn Sie einen Wert für den
Wenn Sie ein Sprite-Objekt vor dem Drucken skalieren möchten, legen Sie die Skaliereigenschaften (siehe
Die Druckfunktion im Flash Player unterstützt PostScript- und Nicht-PostScript-Drucker. Bei Nicht-PostScript-Druckern werden die Vektoren in Bitmaps umgewandelt.
Sie können diese Methode jederzeit aufrufen. Rufen Sie diese Methode auf, bevor ein Druckvorgang gestartet wird, um das Standardpapierformat in den Dialogfeldern „Seite einrichten“ oder „Drucken“ festzulegen. Rufen Sie diese Methode auf, während ein Druckvorgang ausgeführt wird, um das Papierformat für einen Seitenbereich innerhalb des Druckauftrags festzulegen.
Diese Methode ist nicht erfolgreich, wenn der Aufruf der
Der
Auch wenn
Im folgenden Beispiel werden die Einstellungen für die niedrigste und die höchste Seitenzahl im Dialogfeld „Drucken“ festgelegt, bevor das Dialogfeld für den Benutzer angezeigt wird:
Hinweis: Wenn der Benutzer das Druckdialogfeld durch „Abbrechen“ schließt, werden die Eigenschaften nicht eingetragen.
Wenn der Benutzer im Dialogfeld „Drucken“ auf „OK“ klickt, beginnt der Player damit, den Druckauftrag an die Druckwarteschlange des Betriebssystems zu übergeben. Da im Betriebssystem dann Informationen zum Druckstatus angezeigt werden, sollten Sie möglichst bald
Überprüfen Sie zunächst, ob diese Methode
Wenn eines der folgenden Intervalle bei der angegebenen Instanz des Druckauftrags ein Zeitlimit von 15 Sekunden überschreitet, wird beim darauf folgenden Aufruf von
Nach dem Aufrufen dieser Methode kann die PrintJob-Instanz wiederverwendet werden. Wo immer dies möglich ist, werden die Druckeinstellungen zur späteren Verwendung erhalten.
Wenn diese Eigenschaft den Wert
Wenn kein Farben-oder-Graustufen-Wert ermittelt werden kann, ist der Wert
Wenn Sie die Methode
Für jeden Druckauftrag, den Sie mit der PrintJob-Instanz ausführen, legen Sie diese Eigenschaft fest, bevor Sie die
Wenn die Auflösung nicht ermittelt werden kann, wird ein Standardwert verwendet. Der Standardwert ist 600 ppi unter Linux und 360 ppi unter Mac OS. Unter Windows ist die Druckerauflösung immer verfügbar, weshalb kein Standardwert erforderlich ist.
Hinweis: Für AIR 2 oder höher legen Sie diese Eigenschaft fest, bevor Sie einen Druckauftrag starten, um die Standardausrichtung in den Dialogfeldern „Seite einrichten“ und „Drucken“ einzustellen. Legen Sie die Eigenschaft fest, während ein Druckauftrag ausgeführt wird (nach dem Aufrufen von
Hinweis: Für AIR 2 oder höher ist diese Eigenschaft veraltet. Verwenden Sie stattdessen
Hinweis: Für AIR 2 oder höher ist diese Eigenschaft veraltet. Verwenden Sie stattdessen
Hinweis: Für AIR 2 oder höher ist diese Eigenschaft veraltet. Verwenden Sie stattdessen
Hinweis: Für AIR 2 oder höher ist diese Eigenschaft veraltet. Verwenden Sie stattdessen
Wenn Sie den Wert dieser Eigenschaft festlegen, wird sofort versucht, diesen Drucker auszuwählen. Wenn der Drucker nicht ausgewählt werden kann, wird diese Eigenschaft auf den zuvor verwendeten Wert zurückgesetzt. Sie können ermitteln, ob das Festlegen des Druckerwerts erfolgreich ist, indem Sie den Wert nach dem Versuch, ihn zu senden, lesen und überprüfen, ob der mit dem zuvor eingestellten Wert übereinstimmt.
Die
In der folgenden Tabelle sind die ungefähren Formate der einzelnen Papiertypen aufgeführt. Die Format sind deshalb nur ungefähr, da es unter den verschiedenen Druckertreibern leichte Abweichungen gibt. Die Breite einer A4-Seite kann je nach Drucker zum Beispiel 595,0, 595,2, 595,22 oder 595,28 Punkt betragen.