« Gecko Plugin API Reference « Plug-in Side Plug-in API
概要
組み込みやフルスクリーンプラグインにプラットフォーム固有の印刷操作を要求します。
文法
#include <npapi.h> void NPP_Print(NPP instance, NPPrint* PrintInfo);
パラメータ
この関数は以下のパラメータを取ります:
- instance
- 現在のプラグインのインスタンスへのポインタ。組込みかフルスクリーンでなければなりません。
- printInfo
- NPPrint 構造体へのポインタ。
説明
目に見えるプラグイン（組込みかフルページかのいずれか）を含むウェブページに対してユーザが印刷を要求したときに NPP_Print が呼ばれます。プラグインを組み込みのプラグインとして印刷するのかフルページのプラグインとして印刷するかのを決めるために printInfo パラメータ内の NPPrint 構造体で設定された印刷モードを使用します。
- 組み込みのプラグインはブラウザで印刷を共有します; プラグインは占有しているページの一部を印刷し、ブラウザはページの残りの部分の印刷だけではなく印刷ダイアログボックスの表示、印刷デバイスコンテキストの取得や印刷に含まれる他のタスクそれ以外のすべてを扱います。組み込みのプラグインに対しては、printInfo フィールドを NPEmbedPrint に設定します。
- フルページプラグインは印刷自体のすべての側面を扱います。プルページプラグインに対しては printInfo フィールドを NPFullPrint か null に設定します。
あなたのプラットフォーム上での印刷に関する情報については、プラットフォームのドキュメントを参照してください。
MS Windows
On MS Windows 上では printInfo->print.embedPrint.platformPrint はデバイスコンテキスト (DC) ハンドルです。これを必ず型 HDC に確実にキャストするようにしてください。
ウィンドウの長方形の座標は TWIPS フォーマット内にあります。これは テキストを出力するときは Windows API コール DPtoLP を使用して x-y 座標に変換する必要があるという意味です。