PAINTCALLBACK_ISCOMPATIBLEDC Function

Summary

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

Syntax

#include "l_bitmap.h"

L_BOOL pEXT_CALLBACK YourFunction(pDisplay, pBitmap, pUserData)

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

Example

For an example, refer to L_PaintDCCallback.

Help Version 22.0.2023.7.11
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.