resetDCA 函数 (wingdi.h)

ResetDC 函数使用指定的信息更新指定的打印机或绘图仪设备上下文 (DC) 。

语法

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

参数

[in] hdc

要更新的 DC 的句柄。

[in] lpdm

指向 DEVMODE 结构的指针,其中包含有关新 DC 的信息。

返回值

如果函数成功,则返回值是原始 DC 的句柄。

如果函数失败,则返回值为 NULL。

注解

当窗口收到WM_DEVMODECHANGE消息时,应用程序通常会使用 ResetDC 函数。 ResetDC 还可用于在打印文档时更改纸张方向或纸盒。

ResetDC 函数不能用于更改驱动程序名称、设备名称或输出端口。 当用户更改端口连接或设备名称时,应用程序必须删除原始 DC,并使用新信息创建一个新的 DC。

应用程序可以将信息 DC 传递给 ResetDC 函数。 在这种情况下, 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

Esc 键