Share via


CView::OnBeginPrinting

OnPreparePrinting が呼び出された後、印刷や印刷プレビューのジョブの先頭に、フレームワークによって呼び出されます。

virtual void OnBeginPrinting(
   CDC* pDC,
   CPrintInfo* pInfo 
);

パラメーター

  • pDC
    プリンターのデバイス コンテキストへのポインター。

  • pInfo
    CPrintInfo をポイントし、構成します現在の印刷ジョブを記述する。

解説

この関数の既定の実装は、何も行いません。GDI リソースを、印刷専用に必要なペンまたはフォントなどの割り当てるには、この関数をオーバーライドします。これらを使用する各ページの OnPrint のメンバー関数内部からデバイス コンテキストに GDI オブジェクトを選択します。画面の表示および印刷の両方を実行するために同じビュー オブジェクトを使用した各表示に必要な GDI のリソースに対して別の変数を使用してください; これは、印刷時の画面を更新することができます。

またはのプリンター デバイス コンテキストのプロパティに依存する初期化するには、この関数を使用できます。たとえば、文書を印刷するために必要なページ数は、ユーザーが印刷ダイアログ ボックスで指定した設定に依存する場合があります (長ページなど)。このような場合、通常、その OnPreparePrinting のメンバー関数でドキュメント長さを指定できません; プリンター デバイス コンテキストがダイアログ ボックスの設定に基づいて作成されるまで待機する必要があります。OnBeginPrinting はプリンターのデバイス コンテキストを表す CDC のオブジェクトへのアクセスを提供するため、この関数からドキュメントの長さを設定できます。最初のオーバーライド可能関数です。ドキュメント長さがこの時間で指定されていない場合、スクロール バーは印刷プレビュー中に表示されないことに注意してください。

必要条件

ヘッダー: afxwin.h

参照

関連項目

CView クラス

階層図

CView::OnEndPrinting

CView::OnPreparePrinting

CView::OnPrint