ResetDC
The ResetDC
function updates the given printer or plotter device context, based on the
information in the specified structure.
HDC ResetDC(
|
HDC hdc, |
// handle of device
context |
|
CONST DEVMODE *lpInitData
|
// address of
structure with device context information |
|
); |
|
Parameters
hdc
Identifies
the device context to update.
lpInitData
Points to a DEVMODE structure containing
information about the new device context.
Return Values
If the
function succeeds, the return value is the handle of the original device
context.
If the function
fails, the return value is NULL.
Remarks
An
application will typically use the ResetDC function when a window
receives a WM_DEVMODECHANGE message. ResetDC can also be used to change
the paper orientation or paper bins while printing a document.
The ResetDC
function cannot be used to change the driver name, device name, or the output
port. When the user changes the port connection or device name, the application
must delete the original device context and create a new device context with
the new information.
An
application can pass an information device context to the ResetDC
function. In that situation, ResetDC will always return a printer device
context.
See Also