L_SetMagGlassPos

#include "l_bitmap.h"

L_INT EXT_FUNCTION L_SetMagGlassPos(hWnd, nXPos, nYPos)

HWND hWnd;	/* handle to a window */
L_INT nXPos;	/* the new x position of the Magnifying Glass */
L_INT nYPos;	/* the new y position of the Magnifying Glass */

Moves the magnifying glass to the specified position on the screen.

Parameter	Description
hWnd	Handle of the window to which the magnifying glass is attached.
nXPos	The x-coordinate of the new position of the magnifying glass.
nYPos	The y-coordinate of the new position of the magnifying glass.

Returns

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

Comments

The function is used to move the magnifying glass to the position, specified by (x,y), on the screen. Since the user is responsible for displaying the magnifying glass and moving it on the screen in a manual update, this function is used in conjunction with the L_ShowMagGlass function.

If the magnifying glass is displayed, this function will move the magnifying glass to the specified (x,y) position and it will be displayed there. Iif the magnifying glass was hidden, this function will move the magnifying glass to the specified position without displaying it.

This function can be called in the MouseMove message to control the position of the magnifying glass.

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.

Functions:	L_StartMagGlass, L_StopMagGlass, L_ShowMagGlass, L_UpdateMagGlassBitmap, 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