勇芳软件工作室.汉化:  Device Contexts > Device Contexts Functions >

ResetDC

Previous pageReturn to chapter overviewNext page

描述

 

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

 

C++ 语法

 

HDC ResetDC(

__in HDC hdc,

__in const DEVMODE *lpInitData

);

 

PowerBASIC 语法

 

FUNCTION ResetDCA ( _

BYVAL hdc AS DWORD, _

BYREF lpInitData AS DEVMODEA _

) AS DWORD

 

Unicode版本:

 

FUNCTION ResetDCW ( _

BYVAL hdc AS DWORD, _

BYREF lpInitData AS DEVMODEW _

) AS DWORD

 

参数

 

hdc

 

[in]处理DC以进行更新。

 

lpInitData

 

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

 

返回值

 

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

 

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

 

Windows NT / 2000 / XP / Vista / Windows 7:要获取扩展错误信息,请调用GetLastError.

 

备注

 

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

 

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

 

应用程序可以将信息DC传递给ResetDC功能。在这种情况下,ResetDC将始终返回打印机DC。

 

ICM:由hDC参数指定的DC的颜色配置文件将根据DEVMODE结构的lpInitData成员中包含的信息重置。

 

Windows 95/98 / Me:Microsoft Layer for Unicode支持ResetDCW.

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)