PAINTCALLBACK_SETVIEWPORTORGEX Function

#include "l_bitmap.h"

L_BOOL pEXT_CALLBACK YourFunction(pDisplay, nX, nY, lpPoint, pUserData)

L_VOID *pDisplay;	/* device context handle */
L_INT nX;	/* new x-coordinate of viewport origin */
L_INT nY;	/* new y-coordinate of viewport origin */
LPPOINT lpPoint;	/* original viewport origin */
L_VOID *pUserData;	/* pointer to additional data */

This is the callback that replaces the SetViewportOrgEx GDI function.

Parameter	Description
pDisplay	Handle of the device context passed to the paint function.
nX	Specifies the x-coordinate, in device units, of the new viewport origin.
nY	Specifies the y-coordinate, in device units, of the new viewport origin.
lpPoint	Pointer to a POINT structure that receives the previous viewport origin, in device coordinates. If lpPoint is NULL, this parameter is not used.
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

The return values are the same as the return values for the corresponding GDI function.

Comments

The internal display engine calls your callback function if you override the corresponding GDI function in the PAINTCALLBACKDATA structure.

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.

Please see the Microsoft documentation for the values you are expected to return and for the meaning of the parameters before pUserData.

Required DLLs and Libraries

LTDIS

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Example

For an example, refer to L_PaintDCCallback.