ResetDCA 関数 (wingdi.h)

  • [アーティクル]

ResetDC 関数は、指定した情報を使用して、指定したプリンターまたはプロッター デバイス コンテキスト (DC) を更新します。

構文

HDC ResetDCA(
  [in] HDC            hdc,
  [in] const DEVMODEA *lpdm
);

パラメーター

[in] hdc

更新する DC へのハンドル。

[in] lpdm

新しい DC に関する情報を含む DEVMODE 構造体へのポインター。

戻り値

関数が成功した場合、戻り値は元の DC へのハンドルです。

関数が失敗した場合は、返される値は NULL です。

注釈

通常、アプリケーションは、ウィンドウがWM_DEVMODECHANGE メッセージを受信するときに ResetDC 関数を使用します。 ResetDC を使用して、ドキュメントの印刷中に用紙の向きや紙箱を変更することもできます。

ResetDC 関数を使用して、ドライバー名、デバイス名、または出力ポートを変更することはできません。 ユーザーがポート接続またはデバイス名を変更する場合、アプリケーションは元の DC を削除し、新しい情報を含む新しい DC を作成する必要があります。

アプリケーションは、 ResetDC 関数に情報 DC を渡すことができます。 その場合、 ResetDC は常にプリンター DC を返します。

Icm：hdc パラメーターで指定された DC のカラー プロファイルは、DEVMODE 構造体の lpInitData メンバーに含まれる情報に基づいてリセットされます。

注意

wingdi.h ヘッダーは、RESETDC をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wingdi.h (Windows.h を含む)
Library Gdi32.lib
[DLL] Gdi32.dll

こちらもご覧ください

Devmode

デバイス コンテキスト関数

デバイス コンテキストの概要

DeviceCapabilities

Escape