L_DestroyZoomView

Summary

Destroys the specified Zoom View, and releases all resources associated with it. Call this function before destroying the window.

Syntax

#include "l_bitmap.h"

L_LTZMV_API L_INT L_DestroyZoomView(hWnd, uIndex)

Parameters

HWND hWnd

Handle to a window.

L_UINT uIndex

Index of the zoomed view to be destroyed. This is a zero-based index.

Returns

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

Comments

When a zoomed 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.

You must call this function for each Zoom View you have created before destroying the window with which the Zoom Views are associated.

If you need to destroy all the zoomed views that are attached to a specified window, destroy them from the last Zoom View to the first Zoom View. For example, if you have five Zoom Views associated with the specified window you need to do the following:

L_UINT uCount,i; 
L_GetZoomViewsCount(hWnd,&uCount); 
 
for(i=0; i < uCount; ++i) 
{ 
   L_DestroyZoomView(hWnd,uCount-i-1); 
} 

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

L_INT DestroyZoomViewExample(HWND hWnd) 
{ 
   L_INT nRet; 
   L_UINT uCount, i; 
 
   if (!L_WindowHasZoomView(hWnd)) 
      return FALSE; 
 
   nRet = L_GetZoomViewsCount(hWnd, &uCount); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   for (i = 0; i < uCount; ++i) 
   { 
      nRet = L_DestroyZoomView(hWnd, uCount - i - 1); 
      if (nRet != SUCCESS) 
         return nRet; 
   } 
 
   return SUCCESS; 
} 
Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.