L_UpdateZoomView

#include "l_bitmap.h"

L_LTZMV_API L_INT L_UpdateZoomView(hWnd, pZoomViewProps)

HWND hWnd;	handle to a window
pZOOMVIEWPROPS pZoomViewProps;	pointer to a structure

Updates the specified Zoom View with new settings.

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.

Returns

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

Comments

This function should be called any time the image's destination rectangle has been updated in an application. For example, if the image is scrolled or zoomed, call this function with the new destination rectangle.

You should also call this function if you process or change the image in any way (for example, L_FlipBitmap).

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

To attach a zoomed view to a window, call the L_CreateZoomView function. To display a zoomed view, call the L_RenderZoomView 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.

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

Win32, x64.

Example

L_INT UpdateZoomViewExample(HWND hWnd) 
{ 
   L_INT nRet; 
   L_UINT uCount,i; 
   ZOOMVIEWPROPS ZoomViewProps; 
   memset(&ZoomViewProps,0,sizeof(ZOOMVIEWPROPS)); 
   if(L_WindowHasZoomView (hWnd)) 
   { 
      nRet = L_GetZoomViewsCount (hWnd, &uCount); 
      if(nRet != SUCCESS) 
         return nRet; 
      for(i=0; i < uCount;++i) 
      { 
         ZoomViewProps.uIndex = i; 
         nRet = L_GetZoomViewProps (hWnd, &ZoomViewProps, sizeof(ZoomViewProps)); 
         if(nRet != SUCCESS) 
            return nRet; 
         ZoomViewProps.bCallouts = FALSE; 
         nRet = L_UpdateZoomView(hWnd, &ZoomViewProps); 
         if(nRet != SUCCESS) 
            return nRet; 
      } 
   } 
   else 
      return FALSE; 
   return SUCCESS; 
}

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help

Introduction

Version History

Getting Started

LEADTOOLS Raster Imaging Features

Redistributables/Files To Be Included With Your Application

Functions:	L_WindowHasZoomView, L_CreateZoomView, L_GetZoomViewProps, L_DestroyZoomView, L_GetZoomViewsCount
Topics:	Using the Zoom View
	Raster Image Functions: Displaying Images
	Using the Magnifying Glass