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
Example
For an example, refer to L_ShowMagGlass.