StartPage

StartPage 関数は、プリンタドライバがデータを受け付けられるようにする。

StartPage hdc

hdc : [intptr] 印刷ジョブのデバイスコンテキストへのハンドル。

(プラグイン / モジュール : gdi32.dll)

解説

StartPage 関数は、プリンタドライバがデータを受け付けられるようにする。

[戻り値]
関数が成功した場合、戻り値はゼロより大きい。関数が失敗した場合、戻り値はゼロ以下である。

[備考]
注:
これはブロッキングまたは同期関数であり、すぐに返らない可能性がある。この関数がどれだけ早く返るかは、ネットワーク状態、印刷サーバの設定、プリンタドライバの実装といった、アプリケーションの作成時に予測が難しい実行時要因に依存する。ユーザインターフェイスとの対話を管理するスレッドからこの関数を呼び出すと、アプリケーションが応答しないように見えることがある。システムは
StartPage と EndPage 関数の呼び出しの間に ResetDC
関数を無効にする。つまり、ページ境界以外ではデバイスモードを変更できない。EndPage を呼び出した後、必要であれば ResetDC
を呼び出してデバイスモードを変更できる。ResetDC
の呼び出しは、すべてのデバイスコンテキスト属性をデフォルト値にリセットすることに注意。EndPage も StartPage
もデバイスコンテキスト属性をリセットしない。デバイスコンテキスト属性は後続のページ間で保持される。次のページを印刷する前にオブジェクトを再度選択したりマッピングモードを設定したりする必要はないが、そうしても同じ結果が得られ、Windows
のバージョン間のコード差異を減らせる。

情報