印刷するイメージの向き。このプロパティは PrintJobOrientation クラスからの値です。このプロパティは、PrintJob.start() メソッドの呼び出し後にのみ使用可能になります。

関連項目

ページ上で実際に印刷可能な領域の高さ (ポイント単位)ユーザーが設定した余白は含みません。このプロパティは、PrintJob.start() メソッドの呼び出し後にのみ使用可能になります。

関連項目

ページ上で実際に印刷可能な領域の幅 (ポイント単位)。ユーザーが設定した余白は含みません。このプロパティは、PrintJob.start() メソッドの呼び出し後にのみ使用可能になります。

関連項目

用紙全体の高さ (ポイント単位)このプロパティは、PrintJob.start() メソッドの呼び出し後にのみ使用可能になります。

用紙全体の幅 (ポイント単位)このプロパティは、PrintJob.start() メソッドの呼び出し後にのみ使用可能になります。

ページを印刷できる PrintJob オブジェクトを作成します。PrintJob オブジェクトを作成したら、PrintJob.start()、PrintJob.addPage()、PrintJob.send() の順にメソッドを使用して、プリンタに印刷ジョブを送信します。

たとえば次のコードに示される my_pj.addPage() メソッド呼び出しの [params] プレースホルダーテキストをカスタムパラメータと置き換えできます。

 // create PrintJob object
 var my_pj:PrintJob = new PrintJob();
  
 // display Print dialog box, but only initiate the print job
 // if start returns successfully.
 if (my_pj.start()) {
  
    // add specified page to print job
    // repeat once for each page to be printed
    try {
      my_pj.addPage([params]);
    }
    catch(e:Error) {
      // handle error 
    }
    try {
      my_pj.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().
    my_pj.send();
 }
 

最初の PrintJob オブジェクトがアクティブである間は、2 つ目の PrintJob オブジェクトを作成できません。1 つ目の PrintJob オブジェクトがアクティブであるときに new PrintJob() を呼び出して 2 つ目の PrintJob オブジェクトを作成しようとしても、2 つ目の PrintJob オブジェクトは生成されません。そのため 2 つ目の PrintJob を作成する前に my_pj 値を確認することができます。

関連項目

指定の Sprite オブジェクトを 1 ページとして印刷スプーラに送ります。このメソッドを使用する前に、PrintJob オブジェクトを作成し、PrintJob.start() を使用する必要があります。次に、印刷ジョブに対して PrintJob.addPage() を 1 回または複数回呼び出した後、 PrintJob.send() を使用して、スプールしたページをプリンタに送信します。つまり、PrintJob オブジェクトを作成したら、PrintJob.start()、 PrintJob.addPage()、PrintJob.send() の順にメソッドを使用して、プリンタに印刷ジョブを送信します。PrintJob.start() を 1 回呼び出した後で PrintJob.addPage() を複数回使用することにより、複数のページを 1 回で印刷できます。

PrintJob.addPage() によって Flash Player が例外をスローした場合 (PrintJob.start() を呼び出していない場合や、ユーザーが印刷ジョブをキャンセルした場合など) は、その後で PrintJob.addPage() を呼び出すと失敗します。ただし、それまでに PrintJob.addPage() の呼び出しが成功していれば、最後に PrintJob.send() コマンドを実行することで、スプールに成功したすべてのページがプリンタに送られます。

印刷ジョブで PrintJob.addPage() 操作の完了に 15 秒以上かかる場合、Flash Player は、次回の Print.addPage() の呼び出しに例外をスローします。

printArea パラメータの値を渡すと、printArea オブジェクトの x 座標と y 座標がページの印刷可能領域の左上隅 (0,0 座標) に対応します。印刷可能領域は、PrintJob.start() で設定した読み取り専用の pageHeight プロパティと pageWidth プロパティで表されます。印刷結果はページ上の印刷可能領域の左上隅を基準に整列されるので、printArea で定義した領域が用紙上の印刷可能領域よりも大きい場合は、printArea で定義した領域の右側または下側の部分 (またはその両方) は切り取られることがあります。printArea の値を指定しない場合にステージが印刷可能領域より大きいときも、同様の切り取りが発生します。printArea の値を指定しない場合にスクリーンが印刷可能領域より大きいときも、同様の切り取りが発生します。

印刷前に Sprite オブジェクトを拡大/縮小するには、このメソッドを呼び出す前に拡大・縮小のプロパティ (flash.display.DisplayObject.scaleX および flash.display.DisplayObject.scaleY を参照) を設定します。印刷後、これらのプロパティを元の値に戻します。Sprite オブジェクトの拡大・縮小は、printArea とは無関係です。つまり、サイズが 50 x 50 ピクセルの領域を印刷するよう指定した場合、2500ピクセルが印刷されます。Sprite オブジェクトを拡大または縮小している場合、その設定を反映してプリント結果は伸縮しますが、プリントの対象となる 2500 個のピクセルは変わりません。

Flash Player の印刷機能は、PostScript プリンタと非 PostScript プリンタをサポートしています。非 PostScript プリンタでは、ベクターはビットマップに変換されます。

関連項目

PrintJob.start() と PrintJob.addPage() が成功した後、スプールしたページをプリンタに送信します。PrintJob.start() の呼び出しが失敗した場合、または PrintJob.addpage() が例外をスローした場合、PrintJob.send() の呼び出しは成功しません。そのため PrintJob.start() が true を返すことを確認し、PrintJob.send() の呼び出し前に PrintJob.addpage() 例外をキャッチしてください。たとえば、次のようになります。

  var my_pj:PrintJob = new PrintJob();
    if (my_pj.start()) {
    try {
      my_pj.addPage([params]);
   }
    catch(e:Error) {
      // handle error 
   }
      my_pj.send();
  }
  

関連項目

オペレーティングシステムの [印刷] ダイアログボックスを表示し、スプールを開始し、PrintJob の読み取り専用プロパティ値を設定します。ユーザーは [印刷] ダイアログボックスで印刷設定を変更できます。PrintJob.start() メソッドが正常に返された場合、つまりユーザーが [印刷] ダイアログボックスで [OK] をクリックした場合、次の読み取り専用プロパティに値が渡され、ユーザーの現在の印刷設定を表します。

メモ : [印刷] ダイアログボックスでキャンセルすると、プロパティは設定されません。

ユーザーが [印刷] ダイアログボックスで [OK] をクリックすると、オペレーティングシステムへの印刷ジョブのスプールが開始されます。オペレーティングシステムで印刷の進行状況について情報が表示されるため、ページをスプーラに送信したらただちに PrintJob.addPage() および PrintJob.send() を呼び出す必要があります。このメソッドに値を渡す読み取り専用の高さ、幅、方向のプロパティを使用し、印刷結果をフォーマットできます。

PrintJob.addPage() や PrintJob.send() を呼び出す前に、このメソッドが true を返すこと (ユーザーがオペレーティングシステムの [印刷] ダイアログボックスで [OK] をクリックした場合) を確認するために、テストを行います。

  var my_pj:PrintJob = new PrintJob();
     if(my_pj.start()) {
       // addPage() and send() statements here
     }
  

指定された印刷ジョブインスタンスの場合、次のいずれかの間隔が 15 秒以上である場合、次回の PrintJob.start() を呼び出すと false が返されます。

• PrintJob.start() および 1 つ目の PrintJob.addPage()
• PrintJob.addPage() および 2 つ目の PrintJob.addPage()
• 最後の PrintJob.addPage() および PrintJob.send()

関連項目