In This Topic ▼

PAINTCALLBACK_ISCOMPATIBLEDC Function

#include "l_bitmap.h"

L_BOOL pEXT_CALLBACK YourFunction(pDisplay, pBitmap, pUserData)

This callback is used to verify whether the device context and the bitmap handle are compatible with your callbacks.

Parameters

L_VOID *pDisplay

Handle of the device context passed to the paint function.

pBITMAPHANDLE pBitmap

Pointer to the bitmap handle structure we are checking against.

L_VOID *pUserData

Void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData parameter of the PAINTCALLBACKDATA structure.)

Returns

Value	Meaning
TRUE	The device context and the bitmap are compatible.
FALSE	The device context and the bitmap are NOT compatible.

Comments

pDisplay is the pDisplay member from the PAINTCALLBACKDATA structure that you passed to the paint function. The default callbacks expect it to be a HDC handle. But, if you override all the paint callbacks, it can be a pointer of any type you want.

This callback is expected to check both the device context and the bitmap handle and determine whether they are compatible with your callback. If the function returns TRUE, the paint will continue with the current callbacks. If the function returns FALSE, all the other callbacks are ignored and the paint will use the default GDI functions for painting. In this case, the pDisplay member of the PAINTCALLBACKDATA structure is expected to the handle of a valid device context handle. If pDisplay is not a valid device context handle, the paint function will fail.

Required DLLs and Libraries