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.

See Also

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

Example

For an example, refer to L_ShowMagGlass.