L_SetMagGlassPos

#include "l_bitmap.h"

L_LTDIS_API L_INT L_SetMagGlassPos(hWnd, xPos, yPos)

L_HWND hWnd;

/* handle to a window */

L_INT xPos;

/* the new x position of the Magnifying Glass */

L_INT yPos;

/* 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.

xPos

The x-coordinate of the new position of the magnifying glass.

yPos

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 2000 / XP/Vista, Windows CE.

See Also

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

Example

For an example, refer to L_ShowMagGlass.