L_DestroyZoomView

#include "l_bitmap.h"

L_LTZMV_API L_INT L_DestroyZoomView(hWnd, uIndex)

HWND hWnd;	/* handle to a window */
L_UINT uIndex;	/* index of the zoomed view to be destroyed */

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

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

Parameter	Description
hWnd	Handle to a window.
uIndex	Index of the zoomed view to be destroyed. This is a zero-based index.

Returns

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

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_GetZoomViewProps, L_UpdateZoomView, L_GetZoomViewsCount
Topics:	Using the Zoom View
	Raster Image Functions: Displaying Images
	Using the Magnifying Glass

Example

 L_INT DestroyZoomViewExample(HWND hWnd)
{
   L_INT nRet;
   L_UINT uCount, i;
   
   if(L_WindowHasZoomView (hWnd))
   {
      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;
      }
   }
   else
      return FALSE; 
   return SUCCESS;
}