short Escape(hDC, SET_BACKGROUND_COLOR,nCount, lpNewColor,lpOldColor)
This escape sets and retrieves the current background color for the device.
The background color is the color of the display surface before an application draws anything on the device. This escape is particularly useful for color printers and film recorders.
This escape should be sent before the application draws anything on the current page.
Parameter | Type/Description |
hDC | HDC Identifies the device context. | |
nCount | int Specifies the number of bytes pointed to by the lpNewColor parameter. | |
lpNewColor | DWORD FAR * Points to a 32-bit integer specifying the desired background color. This parameter can be NULL if the application is merely retrieving the current background color. | |
lpOldColor | DWORD FAR * Points to a 32-bit integer which receives the previous background color. This parameter can be NULL if the application does not use the previous background color. |
The return value is TRUE if the escape was successful and FALSE if it was unsuccessful.
The default background color is white.
The background color is reset to the default when the device driver receives an ENDDOC or ABORTDOC escape.