PrintWindow 関数 (winuser.h)

  • [アーティクル]

PrintWindow 関数は、指定されたデバイス コンテキスト (DC) (通常はプリンター DC) にビジュアル ウィンドウをコピーします。

構文

BOOL PrintWindow(
  HWND hwnd,
  HDC  hdcBlt,
  UINT nFlags
);

パラメーター

hwnd

コピーされるウィンドウへのハンドル。

hdcBlt

デバイス コンテキストへのハンドル。

nFlags

描画オプション。 次のいずれかの値を指定できます。

値 説明
PW_CLIENTONLY
 ウィンドウのクライアント領域のみが hdcBlt にコピーされます。 既定では、ウィンドウ全体がコピーされます。

戻り値

関数が成功すると、0 以外の値が返されます。

関数が失敗すると、0 が返されます。

解説

メモ これはブロック関数または同期関数であり、すぐには返されない場合があります。 この関数が返す速度は、ネットワーク状態、プリント サーバーの構成、プリンター ドライバーの実装などの実行時の要因によって異なります。これは、アプリケーションを記述するときに予測が困難な要因です。 ユーザー インターフェイスとの対話を管理するスレッドからこの関数を呼び出すと、アプリケーションが応答しなくなる可能性があります。
 
hWnd によって参照されるウィンドウを所有するアプリケーションは 、PrintWindow 呼び出しを処理し、 hdcBlt によって参照されるデバイス コンテキストでイメージをレンダリングします。 アプリケーションは 、WM_PRINT メッセージを受信するか、 PW_PRINTCLIENT フラグが指定されている場合は 、WM_PRINTCLIENT メッセージを受け取ります。 詳細については、「 WM_PRINT と WM_PRINTCLIENT」を参照してください。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-draw-l1-1-2 (Windows 10 バージョン 10.0.10240 で導入)

関連項目

メッセージの描画と描画

描画と描画の概要

WM_PRINT

WM_PRINTCLIENT