L_UpdateMagGlassBitmap
#include "l_bitmap.h"
L_INT EXT_FUNCTION L_UpdateMagGlassBitmap(hWnd, pBitmap, bUpdateBitmap)
|
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 |
Don’t 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 95 / 98 / Me, Windows 2000 / XP, Windows CE.
See Also
Example
For an example, refer to L_ShowMagGlass.