Packageflash.printing
Classepublic class PrintJobOptions
HéritagePrintJobOptions Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

La classe PrintJobOptions contient les propriétés à utiliser avec le paramètre options de la méthode PrintJob.addPage(). Pour plus d'informations sur addPage(), consultez la section de la classe PrintJob.

Voir aussi

PrintJob
PrintJob.addPage()
Tâches Flash Player et impression système


Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
  printAsBitmap : Boolean = false
Spécifie si le contenu de la tâche d’impression est imprimé sous forme de bitmap ou de vecteur.
PrintJobOptions
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
Méthodes publiques
 MéthodeDéfini par
  
PrintJobOptions(printAsBitmap:Boolean = false)
Crée un objet PrintJobOptions.
PrintJobOptions
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Détails des propriétés
printAsBitmappropriété
public var printAsBitmap:Boolean = false

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Spécifie si le contenu de la tâche d’impression est imprimé sous forme de bitmap ou de vecteur. La valeur par défaut est false (impression vectorielle).

Si le contenu à imprimer comprend une image bitmap, réglez printAsBitmap sur true pour inclure tout effet de transparence alpha et de couleur. Si le contenu ne comprend pas d'images bitmap, imprimez le contenu au format vectoriel qui est de qualité supérieure (l’option par défaut).

Par exemple, pour imprimer le contenu sous forme de bitmap, utilisez la syntaxe suivante :

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


Exemple

L'exemple suivant commence par charger une image et la placer dans un rectangle, puis l'imprime sous forme de bitmap.
  1. Le constructeur charge l'image (image.jpg) à l'aide des objets Loader et URLRequest. Il vérifie également si une erreur s'est produite pendant le chargement. Ici, le fichier est supposé être dans le même répertoire que le fichier SWF. Le fichier SWF doit être compilé avec la Protection de lecture locale définie sur Accéder aux fichiers locaux seulement.
  2. Dès que l'image est chargée (l'événement est terminé), la méthode completeHandler() est appelée.
  3. La méthode completeHandler() crée un objet BitmapData et y charge l'image (bitmap). Un rectangle est dessiné dans l'objet Sprite (frame) et la méthode beginBitmapFill() est utilisée pour remplir le rectangle avec l'image (un objet BitmapData). Un objet Matrix est également utilisé pour redimensionner l'image de sorte qu'elle tienne dans le rectangle. (Cela va déformer l'image. Ce redimensionnement est utilisé dans cet exemple pour s'assurer que l'image tienne dans le rectangle.) Dès que l'image est remplie, la méthode printPage() est appelée.
  4. La méthode printPage() crée une nouvelle occurrence de la tâche d'impression et commence le processus d'impression, qui ouvre la boîte de dialogue Imprimer pour l'utilisateur et renseigne les propriétés de la tâche d'impression. La méthode addPage() contient les détails de la tâche d'impression. Ici, la trame qui accompagne l'image (un objet Sprite) est définie pour imprimer au format bitmap et non vectoriel. options est une occurrence de la classe PrintJobOptions et sa propriété printAsBitmap est définie sur true afin d'imprimer au format bitmap (le paramètre par défaut est false).

Remarque : très peu de gestion d'erreurs n'est définie dans cet exemple.

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 myBitmap:BitmapData = new BitmapData(loader.width, loader.height, false);

            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);    
            }
        }
    }
}

Détails du constructeur
PrintJobOptions()Constructeur
public function PrintJobOptions(printAsBitmap:Boolean = false)

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Crée un objet PrintJobOptions. Vous transmettez cet objet au paramètre options de la méthode PrintJob.addPage().

Paramètres
printAsBitmap:Boolean (default = false) — Si la valeur est true, cet objet est imprimé sous forme de bitmap. Si la valeur est false, cet objet est imprimé sous forme de vecteur.

Si le contenu à imprimer comprend une image bitmap, réglez la propriété printAsBitmap sur true pour inclure tout effet de transparence alpha et de couleur. Si le contenu ne comprend pas d'images bitmap, omettez ce paramètre pour imprimer le contenu au format vectoriel qui est de qualité supérieure (l’option par défaut).

Voir aussi





 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/printing/PrintJobOptions.html