L_UpdateMagGlassBitmap

#include "l_bitmap.h"

L_LTDIS_API L_INT L_UpdateMagGlassBitmap(hWnd, pBitmap, bUpdateBitmap)

L_HWND hWnd;	/* handle to a window */
pBITMAPHANDLE pBitmap;	/* pointer to the bitmap handle */
L_BOOL bUpdateBitmap;	/* flag that indicates whether to update the magnifying glass source bitmap */

Updates the magnifying glass bitmap with a new bitmap.

Parameter	Description
hWnd	Handle of the window to which the magnifying glass is attached.
pBitmap	Pointer to the bitmap handle that references the new bitmap that the magnifying glass will display the zoomed area.
bUpdateBitmap	Flag that indicates whether to update the magnifying glass source bitmap. Possible values are:
	Value	Meaning
	TRUE	Update the magnifying glass displayed bitmap with the parts of pBitmap while moving the magnifying glass over the displayed bitmap.
	FALSE	Dont update the magnifying glass displayed bitmap with the parts of pBitmap while moving the magnifying glass over the displayed bitmap.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

The idea is to provide a new bitmap that the magnifying glass can use when displaying the zoomed area. The dimensions of this passed bitmap should be equal to the dimensions of the magnifying glass bitmap.

Note:

This function can be used only if the MAGGLASS_MANUAL_UPDATE flag was set when calling L_StartMagGlass function.

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.

Platforms

Windows 2000 / XP/Vista, Windows CE.

Functions:	L_StartMagGlass, L_StopMagGlass, L_ShowMagGlass, L_SetMagGlassPos, L_CreateZoomView, L_GetZoomViewProps, L_UpdateZoomView, L_DestroyZoomView, L_GetZoomViewsCount, L_WindowHasZoomView, ZOOMVIEWPROPS
Topics:	Using the Magnifying Glass
	Raster Image Functions: Displaying Images
	Using the Zoom View