L_GetZoomViewProps

#include "l_bitmap.h"

L_LTZMV_API L_INT L_GetZoomViewProps(hWnd, pZoomViewProps, uStructSize)

HWND hWnd;

/* handle to a window */

pZOOMVIEWPROPS pZoomViewProps;

/* pointer to a structure */

L_UINT32 uStructSize;

/* size in bytes, of the structure pointed to by pZoomViewProps */

Gets the properties for the specified Zoom View.

This function is available in the Document and Medical Imaging toolkits.

Parameter

Description

hWnd

Handle to a window.

pZoomViewProps

Pointer to a ZOOMVIEWPROPS structure to be updated with options for controlling the behavior of the zoomed view. You must fill pZoomViewProps->uIndex before calling this function.

uStructSize

Size in bytes, of the structure pointed to by pZoomViewProps, for versioning. Use sizeof(ZOOMVIEWPROPS).

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

To attach a Zoom View to a window, call the L_CreateZoomView function.

When a Zoom View is no longer needed, call the L_DestroyZoomView function to stop the specified Zoom View procedure and to detach it from the window handle.

To change the current options for the specified Zoom View, change the values in the structure pointed to by pZoomViewProps and pass a pointer to the updated structure to L_UpdateZoomView.

Required DLLs and Libraries

LTZMV

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.

See Also

Functions:

L_WindowHasZoomView, L_CreateZoomView, L_UpdateZoomView, L_DestroyZoomView, L_GetZoomViewsCount

Topics:

Using the Zoom View

 

Raster Image Functions: Displaying Images

 

Using the Magnifying Glass

Example

For an example, refer to L_UpdateZoomView.