ResetDCW

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

ResetDCW hdc, lpdm

hdc : [intptr] 更新する DC へのハンドル。
lpdm : [var] 新しい DC に関する情報を含む DEVMODE 構造体へのポインタ。

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

解説

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

[戻り値]
関数が成功した場合、戻り値は元の DC へのハンドルである。関数が失敗した場合、戻り値は NULL である。

[備考]
アプリケーションは通常、ウィンドウが WM_DEVMODECHANGE メッセージを受信したときに ResetDC
関数を使用する。ResetDC は、ドキュメントの印刷中に用紙の向きや用紙トレイを変更するためにも使用できる。ResetDC
関数はドライバ名、デバイス名、出力ポートを変更するためには使用できない。ユーザがポート接続やデバイス名を変更した場合、アプリケーションは元の
DC を削除し、新しい情報で新しい DC を作成しなければならない。アプリケーションは情報 DC を ResetDC
関数に渡すことができる。その場合、ResetDC は常にプリンタ DC を返す。ICM: hdc パラメータで指定された DC
のカラープロファイルは、DEVMODE 構造体の lpInitData メンバに含まれる情報に基づいてリセットされる。
> [!NOTE] > wingdi.h ヘッダーは ResetDC を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の
ANSI 版または Unicode
版を自動的に選択するエイリアスとして定義している。エンコーディング中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイルエラーや実行時エラーを引き起こす不一致が発生することがある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報